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Hello, and welcome. 


Please take a moment to read this information. 


This publication is the reference guide for the 
IFS/3000 Interactive Formatting System, a 
software subsystem that runs on the HP 3000. 
IFS/3000 enables you to electronically format 
documents to be printed by an intelligent output 
device such as an HP Laser Printer. 


Overview 


With purchase of an HP 2680A or 2688A Laser 
Printer, you receive a wide selection of print 
formats, known as environment files. A limited 
number of character sets (fonts) are also included. 
Print environments supplied with the HP 2680A 
are listed in Appendix C, Table C-1. HP 2688A 
standard environments are shown in Table C-2. 


To create custom print environments using 
multiple character sets, electronic forms, or 
graphics, the following HP Software products are 
available: 


HP 36580 - Interactive Formatting System 
Software (IFS). Allows the user to combine 
selected character fonts and forms to create 
and compile custom environments. In addition 
to the environments mentioned above, when 
you purchase the IFS program you receive the 
Font Libraries listed in Appendix D. 


HP 36581 - Interactive Design System (IDS). This 
program consists of two parts, IDSFORM and 
IDSCHAR, which provide the user with 
capabilities of designing customized character _ 
fonts, logos and forms. 


HP 36583 - Printer Graphics Package. This 
provides a vector-to-raster conversion 
capability allowing printing of HP 3000 
Graphics (DSG, HP Draw, Easychart) and 
non-HP graphics to HP Laser (HP 2680/2688) 
and Impact (HP 2608S, 2563A, 2565A, 2566A) 
printers. 


HP 36584 Printer Support Package (PSP) This 
product bundles all the above mentioned 
software (36580, 36581, 36583) into one 
package. 


The following figure provides a_ graphic 
representation of the software products. just 
mentioned: 


HP 36580 — IFS Environment HP 36583 


Access GRAPHICS 
IFS Program intrinsics 
Graphics Intrinsics 
LPS Interpreter 


Figmaker Program 


HP 36581 — IDS 


IDSFORM Program 
IDSCHAR Program 





HP 36584 — PSP Package (contains all the above 
IFS/IDS Software Products 


This manual contains information concerning the 
HP 36580 and HP 36583 products. 
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How To Use This Manual 


The way you use this manual will be affected by 
the type of IFS/3000 installation you have on your 
system, and whether you are a programmatic or 
non-programmatic user. 


IFS/3000 is actually a packaged subsystem with 
major components which may be installed in part, 
with limited capabilities; or with full capabilities 
when installed as part of the HP Laser Printer 
Support Package. See your System Manager to 
establish what is available on your system. 


The HP non-graphics software includes the 
IFS/3000 Interactive Formatting System Program, 
the Programmatic Interface which gives you 
additional programmatic control over document 
format, a number of commonly used character 
fonts and document formats, and IDS/3000 for 
development of customized character fonts and 
forms. 


The IFS graphics software includes the Graphics 
Programmatic Interface and the 
non-programmatic Laser Printing System 
Interpreter capabilities supporting document 
formatting control Laser Printer Graphics output. 
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With this in mind, the non-programmer should 
understand the concepts presented in Sections 1 
and 2. This will enable you to determine if IFS 
supplied character fonts and formats meet your 
requirements. If none of the supplied formats 
meet your needs, you should use Section 3 to define 
your own format specifications. 


The Programmer should be familiar with the 
material in Sections 1 through 4 before designing 
application programs with the Programmatic 
Interface presented in Section 5. 


How The Information 
is Presented 


Section 1 reviews the components of a Laser 
Printing System and provides an introduction to 
IFS/ 3000. 


Section 2 reviews the terminology and concepts 
utilized by the components of a Laser Printing 
System. 


Section 3 explains the interactive operation of the 
IFS/3000 program and reviews the menus it 
displays on the terminal screen. You use these 
menus to define the format for your document and 
to supply device-specific printing instructions. 


Section 4 describes the Laser Printing System 
Interpreter which gives you additional 
non-programmatic control over document format. 





Only Section 5, the Programmatic Interface, 
requires knowledge of a programming language. 


Appendix A reviews related MPE Commands and 
Intrinsics. Appendix B discusses use and updating 
of figure files. Appendix C presents Environments 
supplied with the IFS/3000 Formatting Package 
and the HP Printer Support Package. Appendix D 
presents Character Fonts supplied with the 
IFS/3000 Formatting Package and the HP Laser 
Printer Support Package. Appendix E defines 
Vertical Format Control specifications. Appendix 
F provides sample programs. Appendix G reviews 
IFS/3000 Error Messages. Appendix H defines the 
IFS/3000 PCELL File Merge Utility and _ its 
application. Appendix I provides information 
regarding impact printer graphics. 


References to Other 
Documentation 


To use IFS/3000 effectively, you should know how 
to operate the Hewlett-Packard terminals used at 
your facility. Refer to the User’s Manual for the 
terminal you will be using. 


If you require character fonts in addition to those 
supplied with IFS/3000, you can find information 
on designing them in the IDSCHAR Reference 
Guide. 


To design your own forms, refer to the IDSFORM 
Reference Guide. 


If you use the Programmatic Interface, you may 
need the manual for the programming language in 
which you are coding. The following manuals 
contain information you might need as a 
supplement to this reference guide: 


IDSCHAR Reference Guide (36581-90001) 

IDSFORM Reference Guide (36581-90002) 

Laser Page Printer Operator’s Handbook 
(02682-90912) 

2680A Service Manual (02682-90904) 

2688A Operator’s Manual (26088-90901) 

MPE Intrinsics Reference Manual 
(30000-90010) 

MPE Commands Reference Manual 
(30000-90009) 

Using the HP 3000 (03000-90121) 

Using Files (30000-90102) 

2645 Display Station User’s Manual 
(02645-90001) 

2645 Display Station Reference Manual 
(02645-90005) 

2626A Display Station User’s Manual 
(02626-90001) 

2626A Display Station Reference Manual 
(02626-90002) 

2647A Reference Manual (02647-90002) 

2647F Reference Manual (02647-90037) 

2648A Reference Manual (02648-90002) 

TDP/3000 Reference Manual (36578-90001) 

HPWord Reference Guide (32120-90001) 

DSG/3000 Reference Guide (32250-90001) 

HPDraw Reference Guide (32108-90001) 

HPEasyChart Reference Guide (32109-90001) 
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NOTATION 


Co) 





OR, 





nonitalics 


italics 


[ ] 


{ } 


DESCRIPTIGN 


May be used to illustrate specific keys on the terminal keyboard corresponding to the 


label within the symbol, such as the key. On some terminal keyboards 
abbreviated key labels may differ. 


> 


May be used to illustrate specific function labels currently assigned to the special 
function keys labeled f1 through f8 on the terminal keyboard. 


Words in syntax or format statements which are not in italics must be entered 
exactly as shown. Punctuation characters other than brackets, braces and ellipses 
must also be entered exactly as shown. For example: 

EXIT; 


Words in syntax in lowercase italics denote a parameter which must be replaced by a 
user-supplied variable. For example: 


CLOSE filename 


Within syntax, an element inside brackets is optional. Several elements stacked 
inside brackets means the user may select any one or none of these elements. For 
example: 


A User may select A or B or neither. 


Within syntax, when elements are stacked within braces the user must select one of 
those elements. For example: 


{5 User must select A or B. 
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() 


underlining 
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Elements within parentheses within a word or a parameter in syntax or format 
statements are not entered by the user and appear for identification purposes only. 
For example: 


C (OMMAND) User enters C only. 
Y (es) User enters Y only. 


Within syntax, a horizontal ellipses indicates that a previous element may be 
repeated. For example: 


[,itemname]...;3 


When necessary for clarity in an example, user input may be underlined. For 
example: 


NEW NAME? ALPHA 


In addition, brackets, braces or ellipses appearing in syntax or format statements 
which must be entered as shown will be underlined. For example: 


LET var[[subseript]] = value 


When necessary for clarity, the symbol A may be used to indicate a required blank or 
an exact number of blanks. For example: 


SET [ (modifier) ]A(variable); 
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Overview of the 
HP Laser Printing System 


As outlined in the Preface to this Reference Guide, 
you should determine which components of the HP 
Laser Printer Support Package are available on 
your system. You may or may not have all of the 
capabilities of a fully integrated Laser Printing 
System which consists of: 


e an HP Laser Printer 
e the HP non-graphics software which includes: 


IFS/3000 Interactive Formatting System 
which consists of: 
Formatting Programmatic Interface 
LPS Interpreter Formatting Commands 
HP-supplied Environments 
HP-supplied Character Fonts 
HP Character Font Merge Utility 
IDS/ 3000 Interactive Design System 
which consists of: 
IDSCHAR Font and Logo Design 
IDSFORM Forms Design 


e the HP graphics software available includes: 


IFS Graphics 
Graphics Programmatic Interface 
LPS Interpreter Graphics Commands 
HP Figure Maker Utility 

HPDraw 

DSG/3000 

HPEasyChart 


an HP Impact Printer supported by a subset 
of the HP graphics software. 


Each of these components are reviewed in the 
discussions which follow in this section. 


The HP Laser Printer 


The Laser Printer is an electronic page printer 
which uses electrophotographic technology to print 
computer generated output. 


It is helpful to picture output on the Laser Printer 
as the conversion of the file to be printed to a 
pattern of dots (known as bits) which are either 
turned on or off. These dots "cover" the entire 
surface area of a piece of paper and is limited to 
the physical size of the paper and the size of the 
transfer surface on the drum of the printer. 


Controlling the on or off status of the dots is a 
function of the HP Laser Printer Support 
subsystem software. Communicating these 
instructions to the printer along with your file is 
also a function of the software. The Laser Printer 
has the capability to recognize and interpret these 
instructions, store and retrieve the related 
information when it is needed, and convert the file 
to a page image and print it. 
Jan 84 
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These printer capabilities are what classify the 
Laser Printer as an intelligent output device. 


The number of dots which comprise a page is 
determined by the Laser Printer hardware on your 
system. The number of dots is usually referred to 
as dot density (or distribution) and is commonly 
measured in dots per inch. The-shape of each dot 
is also defined by the hardware and determines the 
way dots fit together on the page. This effects the 
pattern of dots needed to form a recognizable 
image. Because of these two dot characteristics, 
most dot control software is device-dependent. 
This means precise instructions on dot location and 
on or off status depend on the output device 
limitations. Since this may differ between device 
models, you will be asked to specify the target 
device when defining instructions to the printer in 
IFS. 


Groups of dots printed on the page become 
intelligible when the pattern is recognizable as a 
letter or line or image. Patterns of letters which 
have an identifiable type style are classified as a 
character Font. Patterns of lines and characters 
which form a static image are classified as a Form. 


The software included in the HP Laser Printer 
Support Package enables you to direct the control 
of these dot patterns in the form of Fonts, Forms, 
and Text. 
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Controlling the combination and position of these 
patterns on the page is called Formatting. 


Combining these formatting components along 
with the specifications for page layout into a single 
file is called creating an environment file. The 
environment file specifications are compiled into 
laser printer compatible formats. This is included 
in the compiled portion of the environment file. 


_ At print time, the environment file is passed to the 


Laser Printer which . interprets incoming 
formatting commands and applies the defined 
specifications contained within the environment. 


The HP graphics software provides the additional 
capability of printing Graphic "pictures" such as 
charts and drawings. 


The Laser Printer Interpreter and the 
Programmatic Interface enable you to merge 
Graphic images with Fonts, Forms, and Text at the 
Laser Printer at print time. Your method of 
control over this integration depends on whether 
you are a programmatic or non-programmatic 
user. 


Features of the 
Laser Printing System 


The features of the Laser Printer hardware 
technology and the HP Laser Print Support 
Package software subsystem are summarized as 
follows: 


e High print speed and print quality. 


e A single interactive program for combining 
formatting components into a single file of 
output specifications which is interpreted at 
print time. 


e Variable types, sizes and rotations of electronic 
character Fonts. 


e Variable types, sizes and rotations of electronic 
Forms. 


e Variable types, sizes, and rotations of electronic 
Graphics. 


e User customization of Fonts, Forms, and 
Graphics. 


e Hewlett-Packard supplied standard character 
fonts and formats. 


e Words, data, and graphics integration at print 
time. 


e Programattic and non-programmatic interface 
for formatting control. 
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Laser Printer Hardware 


Each HP Laser Printer model is described in Figure 
1-1 on the following pages. It is important to note 
the following differences between the printer 
models: 


© The direction of the paper path which 
established the default "page" orientation. 


e The density of the dot distribution which 
establishes device dependent specifications 
when creating, compiling, and calling character 
Fonts and combinations of Forms and Fonts. 


e The dot shape and how each dot is "nested" 
within the dot pattern on the page which 
affects Font and Logo design and their 
compiled and printed orientations. 


Remember to visualize Laser Printer output as a 
pattern of dots whose distribution on the page is 
established by the hardware model on your system. 
You specify the target output device when 
working with the formatting subsystem programs 
(except IDSFORM). This ensures that the 
components of your overall Format, including the 
environment, fonts and forms, will be prepared for 
printing within the limitations of the output target 
device. When you compile these components in to 
a single environment file they are verified to be 
compatible with the output device hardware. 


Refer to the Operator’s Handbook or Operator’s 
Manual for the the Laser Printer model installed 
on your system. A list of this documentation is 
provided in the Preface to this Reference Guide. 
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Figure 1-1. Model 2680A Laser Printer 
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Figure 1-1a. Model 2688A Laser Printer 
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The HP Non-Graphics Software 


Please note that while it is helpful for you to 
understand how the Laser Printer works, you need 
not perform all of the tasks necessary to create the 
components of a formatted document. 


Hewlett-Packard supplies some of the most 
commonly used Environments with the with the 
Laser Printer and some of the most commonly used 
Fonts with IFS/3000. The HP graphics software is 
discussed separately in this section. 


For the Non-Programmer 


To design documents to be printed on the Laser 
Printer, you should understand the concepts in this 
section and Section 2. 


If the format of your document matches one of the 
HP supplied document formats you do not need to 
run the IFS/3000 Interactive Formatting Program 
to create and compile a custom environment. 
Instead, you can use the supplied format by naming 
it in the MPE :File Command to set a file 
equation setting your output format to the 
specified system supplied environment. Refer to 
Appendix A for information on using the :File 
Command and to Appendix C for the formats 
supplied by Hewlett-Packard. If none of these 
formats meet your needs, you should read Section 3 
which contains information on using IFS/3000 to 
define your own formats. 


Section 4 describes the commands used to control 
document format using the Laser Printing System 
Interpreter. 
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For the Programmer 


To design application programs which print 
user-supplied information in a document with a 
specified format, you should be familiar with the 
material in Sections 1 through 4. In addition, you 
should read Section 5 which describes the 
formatting procedures called intrinsics. You can 
use these intrinsics to programmatically direct the 
unique formatting features of the Laser Printer. 
Appendix A contains information on the MPE 
intrinsics and commands which can also be used to 
control document format. 


HP Environments Supplied 
With the Laser Printer System 


The environments supplied with the HP laser 
printing system include environments which 
simulate common printing devices such as line 
printers and typewriters. Using these 
environments is an effective way to become 
familiar with the default page orientation of your 
printer model. It is suggested that you print a test 
file through a number of these’ supplied 
environments so that you become confortable with 
the differences between the orientation of a page 
and the formatting within the page. A discussion 
of sample applications is included along with the 
specifications of each environment provided. You 
will find this approach helpful when progressing to 
the design of custom formats and environments. 


Customization with IDS/3000 


The Interactive Design System/3000 consists of 
two parts: 


e IDSCHAR 
e IDSFORM 


These two interactive, menu-driven programs are 
included with the HP non-graphics software to 
provide the capabilities of designing customized 
character fonts and logos, and forms. They are 
designed for the ‘experienced user and require an 
understanding of character design and forms 
design. Section 2 reviews terminology and 
concepts you should be familiar with before using 
IDS/3000. You should refer to the reference 
documentation for these products as listed in the 
Preface to this Reference Guide. 


When you 

:RUN IDSCHAR. PUB.SYS 
OR, 

:RUN IDSFORM.PUB.SYS 


the programs will present instructions on your 
terminal screen in a format called a menu. This 
menu also lists the choices of functions the 
program is able to perform at the current menu 
location within the program. You specify your 
function choice by using the currently assigned 
special function keys on your keyboard or filling in 
blank fields). Any required data is typed within 
the areas indicated on the menu. These 
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capabilities are what characterize these programs 
as interactive, menu-driven programs. 


You would use these programs to modify existing 
character fonts and forms. You use the interactive 
IFS/3000 program to prepare (compile) the 
character fonts and forms designed with IDS/3000 
for inclusion in an environment file which is the 
format required to be utilized by the Laser 
Printer. 


IDSCHAR 


IDSCHAR is a program which enables you to 
design and modify character fonts and logos. You 
do not need to know a programming language to 
design character fonts with IDSCHAR. You 
should be familiar with the file system used to 
store character fonts and the individual characters 
and logos within a font. You will need a 264X 
graphics terminal to run IDSCHAR and display the 
cell file wherein you create or modify your 
character or logo. For more information on 
character fonts, refer to Section 2 on Terminology 
and to the IDSCHAR Reference Guide (part 
number 36581-90001). 


Character fonts are made up of characters where a 
character can be an alphabetic character, a 
numeral, a special symbol, or a _ logo. 
Hewlett-Packard supplies many of the most 
commonly used character fonts. Using IDSCHAR, 
you can add symbols to these fonts, create your 
own special character fonts, or design business 
artwork, such as company logos or signatures. 


Figure 1-2 illustrates the use of IDSCHAR within 
the HP Formatting System. 
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IDSFORM 


IDSFORM is a program which enables you to 
design and modify forms. You do not need to 
know a programming language to design forms 
with IDSFORM. 


A form is the fixed, static, non-data portion of a 
document. Your form can contain characters 
(character fonts, special symbols, logos, or artwork) 
designed by you with IDSCHAR or provided by 
Hewlett-Packard. You can also include form 
graphics such as lines, boxes, and shaded areas. 


Using IFS/3000, you indicate the forms you want 
to use to print your document. For more 
information on forms, refer to Section 2 on 
Terminology and to the IDSFORM Reference 
Guide (part number 36581-90002). 


Figure 1-2 illustrates the use of IDSFORM within 
the HP Formatting System. 


Interactive Formatting with 
IFS/ 3000 


The Interactive Formatting System/3000 is a 
menu-driven program which enables you to 
combine selected character fonts and forms with 
your formatting specifications for document 
layout. 


IFS/3000 is run once prior to running your print 
job. IFS/3000 then deals with specifications to be 
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used at run time and ultimately controls the 
output at print time. You are guided by terminal 
screen menus presented in logical sequence. Each 
menu contains highlighted areas called fields in 
which you type your requirements. Menu 
conventions and instruction on running IFS/3000 
appear at the beginning of Section 3. 


IFS/3000 converts format components into a disc 
file that can be accepted and interpreted by the 
Laser Printer. This conversion process is called 
compiling and the resulting package of Fonts, 
Forms, and Formats is called an Environment File. 
At print time, the MPE Operating System passes 
the environment file to the Laser Printer prior to 
generating the output. This allows system utilities 
(such as FCOPY, EDITOR and QUERY) or a 
user-written application program to accept 
user-supplied data (such as a text file with 
formatting commands) and print the document as 
specified in the environment file. 


When you compile an environment with IFS/3000, 
the subsystem confirms that all components of the 
environment meet the dot distribution 
specifications of the specified output device. 
Warnings or error messages are issued when 
components do not match the target device 
specified or the file for the component cannot be 
found. See Appendix G for a listing of the 
IFS/3000 error messages, meanings, and suggested 
actions. 


The environment file contains the selected 
components in their compiled format. It can be 
accessed and transferred within MPE file 
conventions. Refer to the Using Files Manual 
(Part Number 30000-90102) for more 
information on maintaining files. Once an 


environment has been successfully compiled, it does 
not need access to the original environment 
components in order to operate as compiled. 


The Programmatic Interface 


The programmatic interface consists of procedures 
called intrinsics which enable a user-written 
application program to control the Laser Printer. 
Environment files created in IFS/3000 are callable 
by the programmatic interface. The user program 
may be written in COBOL, COBOL II, BASIC, 
FORTRAN, SPL, or PASCAL. This flexibility 
allows you to programmatically vary output 
characteristics such as character fonts or forms 
while the application program is being run. Thus, 
the document format can be changed to 
accommodate user-supplied data. 


One of the features of the programmatic interface 
enables you to print data into a form symbolically 
using named fields defined in IDSFORM, thus 
eliminating the need for "print and space" 
positional forms interfacing. IDSFORM continues 
to support "print and space" protocol to provide 
compatibility with existing application programs. 
The programmatic interface also enables you to do 
such things as vary the direction of printing and 
extract information about the widths of 
proportionally spaced characters for text processing 
applications. 


If you have the HP graphics software, you can also 
use the programmatic interface to print graphics 
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output on the Laser Printer, and to merge text 
with graphics at print time. 


Section 5 discusses the details of the programmatic 
interface. 


The LPS Interpreter 


The Laser Printing System Interpreter consists of 
formatting commands which are embedded in a 
text file to give the Laser Printer formatting 
instructions at print time. These commands give 
you the same formatting control as the 
programmatic intrinsics, but you do not need to 
know a programming language to use the LPS 
Interpreter. Text files can be any ASCII file 
created with an HP 3000 text editor. The LPS 
Interpreter requests that you specify an 
environment file as well as the target output 
device before accepting your text file. 


The LPS Interpreter allows you to do such things as 
print text with varying character fonts on 
different page layouts. If you have the HP 
graphics software, you can also print documents 
which merge text and graphics. Like the 
programmatic interface, the LPS _ Interpreter 
enables you to print data into a form using named 
fields. 


Section 4 discusses the details of the LPS 
Interpreter. 
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Figure 1-2. Overview of Laser Printing System 
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HP Graphics Software 


The HP graphics software allows you to print 
figures on the Laser Printer. These figures must 
first be created with DSG/3000, HPDraw, 
HPEasyChart, or the graphics Figure Maker 
utility. 


A figure must be converted to a partitioned raster 
image file before it can be accepted by the Laser 
Printer. 


The IFS/3000 graphics intrinsics and the LPS 
Interpreter graphics commands allow the 
programmer and the non-programmer to convert a 
figure in a figure file into a partitioned raster 
image file. A copy of this partitioned raster image 
file is then loaded into Laser Printer memory, 
printed, and if desired, deleted from Laser Printer 
memory. 


By saving the partitioned raster file you may 
reprint the raster image without reconverting the 
original figure file. Thus, printing a previously 
converted image saves time and system resources. 


Section 4 describes the LPS Interpreter Graphics 
commands used to control graphics integration 
with your document by passing formatting 
commands directly to the Laser Printing System 
Interpreter at print time. 
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Section 5 describes the formatting procedures 
called intrinsics which enable you to 
programmatically convert figures and integrate 
them with your document at print time. 


Figure 1-3 gives an overview of graphics output 
on the Laser Printer. 
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Figure 1-3. Graphics output in the Laser Printing System 
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Overview 


The HP Laser Printer and the formatting software 
subsystems provide extensive flexibility in defining 
the format of your printed document. The 
Interactive Formatting System/3000 enables you 
to combine the components of the HP 
non-graphics software into a single file called an 
environment file. This environment file contains 
specifications for the physical page, character 
fonts, forms and logical pages. A logical page is a 
rectangular area on the physical page used for 
formatting. The environment file provides the 
following printing capabilities: 


e multiple character fonts per line of print 

e use of the different sizes available of the same 
character font or logo 

e different orientations of the same character 

font or logo 

multiple logical pages per physical page 

multiple orientations of logical pages 

up to two forms on each logical page 

multiple copies of each physical page 

graphics charts and drawings on any page 


Some of these components are supplied by 
Hewlett-Packard. All of these components are 
customizable. You should be familiar with the 
Terminology and Concepts presented in this section 
when using IFS/3000 to design custom 
environments, and when using IDS/3000 to design 
custom components for the environment. 


This section will be particularly helpful when 
using the the IFS/3000 Merge Utility which 
enables you to merge different character fonts, 
sizes, and rotations within the same Character Font 
File. 


For more detailed information on _ electronic 
characters and forms and their design, refer to the 
IDSCHAR Reference Guide (part number 
36581-90001) and the IDSFORM _ Reference 
Guide (part number 36581-90002). 
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IDSCHAR Terminology 


IDSCHAR is a subsystem of IDS/3000 and is 
included in the HP non-graphics software. 


The IDSCHAR Reference Guide is written 
primarily for graphics designers and others who 
have a basic understanding of typesetting 
terminology. This section will review the basic 
terminology you will encounter when using 
IDSCHAR with IFS/3000 to supply customized 
character fonts or logos for your environment. 


You should also review the IFS/3000 Merge 
Utihity in Appendix H which enables you to 
combine different fonts, sizes, and rotations within 
the same Character Font File. 


IDSCHAR is device dependent, as dot density and 
dot shape are defined by the printer hardware 
installed on your system. This will affect the 
design of Character Fonts and Logos and their use 
with IFS/3000. 


Character Cell 


A character designer defines a character cell using 
IDSCHAR. The content of a character cell is a 
character which is a pattern of dots within the cell, 
as shown in Figure 2-1. Typical contents of a 
character cell could be a letter such as the "B" in 
our example; or a logo, or other artwork. 


The dot pattern within a character cell may range 
from a single dot to a maximum of 255 dots wide 
by 255 dots high. 
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You will need to convert the cell dot size to the 
standard point size measurement used to designate 
type sizes on the Character Font Menu in 
IFS/3000. There are 72 points to the inch. Your 
Laser Printer dot resolution is expressed in dot 
density per inch. Divide the dots per cell into the 
printer dots per inch to determine the cell size in 
inches for the target output device. Multiply the 
standard 72 points per inch by the cell size in 
inches to determine your cell point size. To be 
consistent, the character within the cell should be 
positioned within the cell so that it maintains the 
point size you intend to specify in IFS/3000. 


If a character within a character font has not been 
specified, a solid black rectangle will be printed in 
place of the undefined character (cell). 


CELL 








Figure 2-1. Character Cell 


Character Code Number 


The character designer assigns a character code 
number to each character during the design 
process. The Laser Printer uses the character code 
number along with the character font number to 
refer to a character when printing it. It is not 
necessary for you to know the character code 
number in order to use it for printing. Refer to 
the paragraph on Character Font Number in this 
section. 


A character font can contain up to 128 characters. 
The location of the character (cell) within the 
character font is determined by the character code 
assigned to a position from Oto 127. Character 
codes 0 through 32, and code 127 are reserved for 
use by IFS/3000. The remaining 94 code 
positions, 33 through 126, are available for design 
use. Code position 32 is defined as a blank to be 
consistent throughout font design. 


Since more than 95 character codes are required to 
fully define any European language, a pair of 
character sets are linked together. The first 95 
characters in the pair are the standard ASCII 
character set; the second 95 characters in the pair 
are the Roman Extension to the ASCII character 
set. Appendix D provides details of these paired 
character sets and Appendix C lists the supplied 
environments in which they are used. 


A character code number can be used in more than 
one character font. If a given character is 
included in several character fonts, the same code 
number is normally used for that character in each 
of the fonts. For example, the character code 
number decimal 67 would normally represent the 
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letter "C" in all character fonts containing the 
English alphabet. 


For consistency, the character code number is 
normally the ASCII number for the character. For 
example, the character codes for the following line 
of print appear beneath each character, read 
vertically: 


ASCII Characters and Character Codes 
686 773619199111139113619199111361111 
537332707179101127102707179101271001 

44 61452 00 44 614 1615 


For information regarding ASCII codes refer to the 
MPE Pocket Guide (30000-90049). 


If you do not need all the characters in a given 
character font, you can save space in your 
environment file and in the Laser Printer memory 
by selecting only the block of characters you need. 
You can identify the desired range of characters by 
entering the starting and ending character code 
numbers on the Character Font Menu in 
IFS/ 3000. 


This is particularly useful when an environment 
contains a large number of character fonts, or 
when only a few characters have been designed in 
a specific font, especially if a large cell size is used. 
If you ever encounter the printer error "Not 
enough room for character set download", you may 
solve the problem by specifying that only a range 
of characters be used. 
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Character Font 


A character font is a collection of character cells, 
where each character is normally in the same 
typeface and size. Each character in a character 
font is assigned a character code number as 
described above. An example of a character font is 
the Times Roman typeface and 10-point typesize. 
Hewlett-Packard supplies a selection of character 
fonts as described in Appendix D. 


You can use up to 32 different character fonts to 
print a document. Laser Printer memory 
limitations may allow less than this, but 32 is the 
maximum number you can use in one environment 
file. You can use these fonts in any combination 
on a page and can interchange them within a 
single line of print. 


Character Font Number 


After you choose the character fonts you want to 
use to print data in your document, you identify 
them using the Character Font Menu in IFS/3000. 
For reference purposes, you associate a number and 
an optional name with each character font you 
select. The character font number is used for 
character font selection at print time. 


You can print character fonts in any one of four 
orientations: Landscape, Portrait, Reverse 
Landscape, and Reverse Portrait. To reference the 
various orientations, you must assign a different 
character font number to each orientation and size 
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of any given typeface when specifying an 
environment in IFS/3000. 


Primary and Secondary 
Character Fonts 


When fonts are defined using the Character Font 
Menu, the printer will default to the font which 
has been assigned the lowest font number as the 
primary character font. This font will always be 
initially active. In other words, unless you do 
something to change it, the printer will use the 
primary character font when it begins to print a 
document. 


The font which has been assigned the next higher 
number (using the Character font Menu), will be 
considered the secondary character font. You can 
change to the secondary character font and back 
again at any time as follows: 


CHANGING FROM PRIMARY TO SECONDARY 
CHARACTER FONTS 


You can direct the printer to change between 
primary and secondary character fonts by using 
the SHIFT OUT (ASCII 14=CTRL N) and SHIFT 
IN (ASCII 15=CTRL O) characters. You can 
include these signals in the data or 
programmatically send them to the printer. 


You can also cause a change to the secondary 


character set by setting the eighth bit to 1 (on).* 
If you set the eighth bit on, the Laser Printer uses 
the secondary character font until you turn the 
eighth bit off. If no SHIFT OUT was previously 
in effect, then the printer reverts to the primary 
character font. 


If the eighth bit is off, the printer uses a secondary 
character font whenever it encounters a SHIFT 
OUT (CTRL N) and the primary character set 
when it encounters a SHIFT IN (CTRL O). 


In the following example, the secondary character 
set is a bold font, and SHIFT OUT and SHIFT IN 
are used to print only the word "BOLD" in the 
secondary character set: 


This isa CTRL N BOLD CTRL 0 font. 


You can also change fonts in a text file using the 
LPS Interpreter USEFONT command and | shift 
character (ie. the vertical bar accessed in the 
shift position). See the USEFONT command 
desciption in Section 4 for more information. 


Cell File 


A cell file is a disc file in which IDSCHAR stores 
the character cells the make up a character font. 
Refer to the IDSCHAR Reference Guide (part 
number 36581-90001) for detailed information on 
cell files. Appendix D describes the cell files 
supplied with the HP non-graphics software. If 
you are designing an environment file from 
scratch, you need to know the name of the cell 
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files containing the character fonts or logos you 
want to use to print your document. The 
character font designer assigns the cell filename 
when designing the cell file with IDSCHAR. 


There are two kinds of cell files: 


e Character Font File 
e Logo File 


Character Font File 


A character font file normally contains multiple 
sizes of the same character font. However, it can 
contain any combination of character fonts and 
sizes. You would use the IFS/3000 Merge Utility 
to merge character fonts of the same font designed 
for different Laser Printer devices. It 1s 
recommended that you do not merge character 
fonts of different font types. 


In a character font file, an "A" chosen from one 
size should appear almost identical to any other 
"A" in the same file, except for its size. Appendix 
D lists the sizes available for the character fonts 
supplied with IFS/3000. 


Logo File 


A logo file contains only one logo. There may be 
several sizes of the logo in a logo file. 


*For example, you might set the eighth bit on by configuring some HP terminals to eight bit mode for use 


with various foreign language keyboards. 
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Logos designed with IDSCHAR may be included in 
a form designed with IDSFORM. A letterhead 
with a company logo would be an example of this 
application. The forms designer specifies at design 
time the cell filename in which the logo resides on 
the Field Font and Subfield Description Menu in 
IDSFORM. 


To, print the form with the logo, you specify the 
form and form filename on the Logical Page Forms 
Menu in IFS/3000. IFS/3000 verifies that the 
logo or any other character font file references can 
be found and compiled with the form. At this 
point the logo is part of the logical page and will 
print when the logical page is activated. 


If you wish to print a logo within the text of a 
document, you specify the logo filename as the cell 
file on the Character Font Menu in IFS/3000. 
The logo is automatically given the character code 
number "76", the ASCII code number for the 
uppercase letter "L". IFS/3000 automatically 
includes the logo character in the character font. 
Since there is only one logo per logo file, both the 
highest and lowest character code numbers are set 
to character code number "76". To print the logo, 
you select the logo file as the character font you 
want to print with and then print the uppercase 
character "L". 


Depending on the logo size, you could consider 
creating a character font of logos, where each logo 
has a character cell position within the character 
font and is called by character position as a special 
character font. The cell size required would 
determine if this application is practical. 
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Character Font Orientations 


The capability of printing characters in different 
orientations is one of the features of the Laser 
Printer hardware. Since dot distribution and page 
orientation are device dependent, you should 
establish these two specifications for the printer 
model installed on your system. 


The Laser Printer does not rotate characters as it 
prints them. It uses your instructions to make a 
selection from the character font orientations 
included in the environment file. 


IDSCHAR allows you to design characters in all 
four orientations: 0, 90, 180, and 270 degree 
rotations. Designing a character in more than one 
orientation is important if the output printing 
device has asymmetrical dots or grids. You should 
determine the dot shape for the Laser Printer 
model installed on your system. If the dot shape is 
other than round or square, characters will may 
appear distorted when rotated by IFS/3000. 
Directly opposite rotations (reverse) should not 
appear distorted regardless of the dot Shape. If 
orientations are specified, when creating an 
environment, which IFS/3000 cannot find within 
the filename specified, IFS/3000 will rotate the 
existing font within the Landscape, Portrait, 
Reverse Landscape, and Reverse Portrait 
orientations as specified on the Character Font 
Menu. It will not verify that the resulting font 
may print with a distortion. A separate character 
font must be defined in IFS for each orientation 
desired in the environment. 
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a° 90" 180° 


270° 


Figure 2-2. Character Font Orientations 


Character Font Sizes 


The Laser Printer can print the different sizes of 
any character font generated by IDSCHAR. The 
different character font sizes must be compiled for 
the Laser Printer prior to printing. IFS/3000 will 
prepare the selected characer font for the Laser 
Printer from the sizes listed in Appendix D, or 
from a font size you created with IDSCHAR. 


You can use different print sizes for purposes such 
as printing more information in a given space, thus 
saving paper, or for emphasizing various parts of 
your document. You can use different character 
sizes defined in the environment in any 
combination on a particular page including 
interchanging them within a single line of print. 
This feature enables you to use character sizes for 
titles or illustrations that are different from the 
character sizes used in the body of the text. 


For example, the environment file used to produce 
this Reference Guide contains the Helvetica 
Character Font in the following sizes: 


10 Point BOLD 
12 Point BOLD 
14 Point BOLD 


20 Point BOLD 
24 Point BOLD 


IFS\3000 does not generate character font sizes by 
scaling new dot patterns. Instead, it looks for the 
character font size you specify on the Character 
Font Menu in IFS/3000 within the character font 
filename you specify. It does provide the option of 
specifying the next smaller or larger size found 
within the filename provided if the specified size is 
not found. However, the font size selected with or 


- without this option must exist as a character font. 


The designer uses IDSCHAR to design each size of 
a particular typeface as a separate character font, 
prior to any reference to it in IFS\3000. 
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THIS PAGE SHOULD BE BLANK 


Sept 84 
2-6.2 


IDSFORM Terminology 


IDSFORM is a subsystem of IDS/3000 and is 
included in the HP non-graphics software. 


The IDSFORM Reference Guide is written 
primarily for graphics designers and others who 
have a basic understanding of graphics layout 
terminology. This section will review the basic 
terminology you will encounter when using 
IDSFORM with IFS/3000 to supply customized 
forms for you environment. 


IDSFORM is not device dependent if your form 
only contains lines, boxes, and shading graphics. 





If your forms contain Titles, Headings, 
Logos, or Text, the character fonts 
specified on the Field Font and Subfield 
Description Menu in IDSFORM are device 
dependent. When converting forms for an 
alternate Laser Printer device, IFS/3000 
will issue a error message when compiling 
the form specified on the Logical Page 
Menu if the character fonts or logos 
specified within the form in IDSFORM are 
not available in the size specified for the 
device specified in IFS/3000. If the fonts 
or logos required are not available for the 
device specified, you will need to run 
IDSFORM and respecify the character font 
and logo references to ones that are 
available. If no existing alternatives are 
suitable, you would use IDSCHAR to design 
fonts and logos suitable for the form to be 
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converted for the alternate printer device. 
These new fonts and logos would need to be 
specified in IDSFORM. 


Forms 


A form is the fixed, non-data portion of a 
document or report. A form can include titles, 
headings, logos, lines, boxes, and shading. Figure 
2-3 is an example of a form which the Laser 
Printer can print as a blank form or as a form 
filled out with data as illustrated in Figure 2-4. 
Data issued to the form may be formatted 
(positioned) within the form at print time either 
programatically or non-programatically. Refer to 
the PNEWFORM Programmatic Interface intrinsic in 
Section 5, or the .NEWFORM LPS Interpreter 
command in Section 4. Your text editor may also 
provide formatting commands which enable you to 
position data on the logical page which prints 
within the form boundaries. 


The electronic forms capability allows an 
application program to dynamically — select 
different forms, possibly dependent on data, and 
print the data in the form without requiring 
manual intervention by an operator. A program 
which reported periodic data on different forms 
only if data associated with a specific form was 
present would be an example of this application. 
You can use electronic forms to replace preprinted 
forms, eliminating the need to purchase, store, and 
load different forms for each document. 


Jan 84 
2-7 


TERMINOLOGY 
Subforms 


Subforms are sections within a form and are 
accessible using the PNEWSUBFORM Programmatic 
Intrinsic or the .NEWSUBFORM LPS Interpreter 
command. They are designed in IDSFORM along 
with associated form. Subforms enhance your 
capabilities to simulate multi-copy carbons where 
duplicated formats have modified subforms on 
subsequent copies. 


Forms File 


A forms designer defines electronic forms using 
IDSFORM (see figure 2-3). The forms are stored 
in a disc file called a forms file. Normally all 
forms used by a specific application or 
environment are stored in the same forms file. 
You can associate forms with the logical page, and 
multi-copy forms with the physical page. To do 
this, you enter the form name and forms filename 
on the Logical Page Menu or the Multi-Copy 
Forms Table Menu in IFS/3000 when specifying 
your environment. To fill in the form with data, 
an application program accesses the form through 
the associated logical page (see figure 2-4). 


The Laser Printer can store up to 30 forms 
simultaneously depending on the complexity of the 
forms. You can merge forms in different 
combinations on each physical page. This is useful 
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when simulating carbon copies where part of the 
form is changed from copy to copy. For more 
information on multi-copy forms, refer to the 
Section 3 discussion of the Physical Page and 
Environment Defaults, and Multi-Copy Forms 
Table Menus. 


Muilti-Copy Forms 


You can simulate multi-copy forms where parts of 
a form vary from one copy to the next while the 
data printed to the form remains the same. To do 
this, you can use the Multi-Copy Forms Table 
Menu to specify up to eight pairs of forms to be 
printed on the physical page. In each pair of 
forms, one form may define the parts which vary 
from one copy to the next, while the second form 
may define the parts which remain constant for all 
copies. By overlaying a pair of forms on the 
physical page, you simulate one of the pages in a 
multi-copy form. The next pair of forms can 
simulate the next page of the multi-copy form, 
and so forth. 


IFS/3000 automatically rotates and positions 
multi-copy forms so that they are centered on the: 
logical page for the HP2680A model Laser Printer, 
only. 


For more information on multi-copy forms, refer 
to Multi-Copy Forms Table Menu in Section 3. 
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EMPLOYEE INFORMATION FORM 


EMPLOYEE NO. LAST NAME ‘MIDDLE 


SOCIAL SECURITY NO. 


HOME PHONE NUMBER ) WORK EXTENSION NUMBER | DATE OF BIRTH (M/D/Y) 


LOCATION NUMBER DISTRIBUTION | DATE OF HIRE (M/D/Y)} 





Figure 2-3. An Electronic Form 


EMPLOYEE INFORMATION FORM 


EMPLOYEE NO. LAST NAME MIDDLE 


04987 CHASE NOAH 
STREET ADDR 1234 EAST APPLE ROAD 


SOCIAL SECURITY NO. 


CITY & STATE BOISE, IDAHO ZIP 83707 860 54 9876 
"HOME PHONE NUMBER ~ WORK EXTENSION NUMBER DATE OF BIRTH (M/D/Y) 


922-4328 2680 12/31/53 
LOCATION NUMBER DISTRIBUTION DATE OF HIRE (M/D/Y) 


4340 7/04/73 
PERSONNEL 





Figure 2-4. Form Merged With Data 
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iFS/3000 Terminology 


IFS/3000 is a menu-driven program supplied with 
the HP non-graphics software. It enables you to 
combine selected character fonts and forms with 
your formatting specifications for document 
layout. 


When using an environment you have created 
yourself, IFS/3000 is run once prior to running 
your print job. A compiled version of your 
specifications is prepared which can be passed to 
the Laser Printer, and which ultimately controls 
your output at print time. You are guided by 
terminal screen menus presented in _ logical 
sequence. Each menu contains highlighted areas 
called fields in which you type your requirements. 
Menu conventions and instruction on running 
IFS/3000 appear at the beginning of Section 3. 


IFS/3000 is device dependent which will affect 
your ability to combine device dependent 
components of your formatting specifications. 
Warning and Error Messages are issued when 
problems are encountered while compiling your 
specifications for the specified output device. 
Refer to Appendix G to review Error Messages, 
their meaning, and proposed actions. 


Defauit Environments 


The Laser Printer contains a default environment 
consisting of a simulated line printer character 
font, no forms, and a single logical page per 
physical page with 132 characters per line and 66 
potential print lines per page. The physical page 
in the default environment has proportions similar 
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to a 14x 11 inch line printer page, but is only 11 
inches wide and 8.5 inches high. This default 
environment is always present in the Laser Printer 
unless it is overwritten by an environment you 
define. Refer to Appendix C for the default 
environment specifications. 


If you do not wish to use the Laser Printer default 
environment just described, you can use one of the 
environments supplied with the Laser Printing 
System. Appendix C describes the supplied 
environments. You can also create your own 
environment using IFS/3000. To do this, refer to 
Section 3 of this manual after reviewing the 
terminology presented in this section. 


Environment File 


The environment file identifies the character fonts, 
forms, and other printing requirements needed by 
a particular print job or a set of print jobs. The 
environment file is in a format that is specific toa 
particular target output device. 


An environment file consists of two parts: 


*® The physical page, logical page(s), and character 
font(s) specifications. 


© The compiled version of these components and 
specifications. 


You use IDS/3000: IDSCHAR and IDSFORM, to 
design and modify specification components of an 
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environment. IFS/ 3000 
components in five steps: 


combines these 


e Requests the definition of the physical page. 


e Accepts character ceil file references for 
character fonts and logos you wish to have 
available to print on the physical page. 


a Accepts logical page definitions. 


® Accepts forms file references for forms you 
wish to include in the definition of logical 
pages to be printed on the physical page within, 
or less than, the size limits of the physical page. 


@ Compiles these specifications by locating the 
files referenced and converting them to into a 
format that can be passed as a single file, called 
an environment file, to the Laser Printer. 


wompiling the Environment 


Any character cell or forms file references you 
make on the Character Font and Logical Page 
Menus in IFS/3000 are verified when you press 
(ENTER) when entering the filenames. Warning 
messages are issued when a file reference cannot be 
found, or a specification does not fit within the 
limits of the physical or logical page. A successful 
file reference only indicates that the file is 
accessible to IFS/3000. It does not verify that the 
contents of the file meet the specifications of the 
target output device. 


When you have completed your environment 
component references, you are ready to compile 


the environment to convert components that are 
not already device specific to a file format that is 
device specific. 


This procedure is called compiling the 
environment. Each page, font and form are 
prepared for the Laser Printer model you specify; 
including the orientation, size, and formatting 
specifications of each component. IFS/3000 
assigns the number you specify on the Logical Page 
and Character Font Menus to the compiled 
components, along with optional names if also 
specified. The assigned number is used by the 
Laser Printer to locate, activate, or deactivate 
fonts, logical pages, forms or subforms as instructed 
by the application program or data file. Refer to 
the discussions on character fonts and logical 
pages. Instructions can be issued either 
programmatically or non-programmatically, 
within or along with a data file sent to the Laser 
Printer preceeded by the environment file 
designation. The font, form, or page must exist in 
its compiled form in the environment specified to 
be used by the Laser Printer and is applied to the 
data file at print time. 


The dot density and dot shape are determined by 
the hardware model you specify on the Main Menu 
in IFS/3000. You should review the IDSCHAR 
and IDSFORM terminology in this section to 
determine the effect of converting and compiling 
dot specific patterns for the target output device. 


The compiled environment file maintains the 
specified components in the Laser Printer format. 
It no longer needs the files referenced unless the 
environment file is opened with IFS/3000 and 
completely recompiled. 
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If you make changes to the specifications without 
compiling the environment, the compiled part 
which existed prior to the changes still exists. The 
changed specifications are available for printing 
the document after the environment has been 
recompiled. However, if the compile step does not 
complete successfully, the compiled part of the 
environment file is not available. You cannot use 
the environment for printing the document until it 
is successfully recompiled. 


If the compile step fails, IFS/3000 displays error 
messages indicating the problems encountered. 
You may have to exit IFS/3000 to modify a design 
component if the error is due to a file reference or 
error within the component. After you correct the 
errors, return to the IFS/3000 Main Menu to 
recompile the environment. 


IFS/3000 recompiles the parts of the environment 
which have not already successfully compiled and 
always recompiles the logical and physical pages. 
You may repeatedly make corrections or changes 
and recompile the environment until all parts are 
successfully compiled. 


specifying the Environment 


Your compiled environment file must be associated 
with the document you want to print. You can do 
this in several ways: 


1. Include your environment filename as a 
parameter in the MPE :FILE command for 
your output print file. You may use a :FILE 
command with supplied subsystems such as 
EDITOR, TDP/3000, QUERY or FCOPY, as 
well as with your own programs. For example: 
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>FILE JOB;DEV=PP;ENV=PICA.HPENV.SYS 


OR 


? 


:FILE JOB;DEV=PP88;ENV=PICA.HPENV.SYS 


2. Use your environment filename in the MPE 
FOPEN intrinsic within the related application 
program. 


Refer to Appendix A for information on 
identifying the environment file in either the 
MPE :FILE command or the FOPEN intrinsic. 
For more information on using files on the HP 
3000, refer to the Using Files Manual (part 
number 30000-90102). 


3. Use the \ENVIRONMENT filename command 
if you are printing a TDP/3000 text file. For 
more information, refer to the TDP Reference 
Manual (part number 36578-90001). 


4. Supply the name of your environment file to 
the LPS Interpreter if you are printing a text 
file. For more information, refer to Section 4 
of this reference guide. 


The Physical Page 


The physical page refers to the actual paper 
surface that passes through the printer and 1s 
exposed to the printers electrophotographic 
transfer drum. Its physical size is determined by 
the Laser Printer model installed on your system. 
Refer to the Operator’s Handbook for your printer 
model to determine the paper and, therefore, the 
physical page sizes available. 


The physical page dimensions are specified on the 
Physical Page and Environment Defaults Menu in 
IFS/3000. Its size establishes the maximum 
dimensions available for printing all other 
components of your environment. Each printer 
model also has unique border areas along the edges 
of the physical page which are outside of the 
transfer area of the printer transfer drum. Any 
specifications you define which extend beyond the 
physical page size or fall within the border areas 
will result in warning or error messages specific to 
the limitations exceeded. 


The Laser Printer and the software subsystems 
which support its operation enable you to format 
the print area on the physical page. Formatting of 
the physical page consists of two basic sets of 
specifications: 


e subdividing the physical page area in the form 
of logical pages. 


e defining the vertical spacing per print line and 
between the lines of print. 


Physical Page Copies 


You can simulate carbon copies of a single physical 
page document by entering the number of copies 
on the Physical Page and Environment Defaults 
Menu. Copies defined in this way are generated 
by the Laser Printer itself, rather than by the host 
computer system. 


To produce multiple copies of a multi-page 
document using the Laser Printer, you have two 
alternatives: 
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e request multiple copies of each page on the 
Physical Page and Environment Defaults Menu 
and then collate the pages manually. 


e retransmit the entire document from the host 
multiple times. If retransmitting is desired, you 
do not have to run the application program 
multiple times but rather, you can specify the 
additional copies via the spooler. 


Logical Pages 


A logical page is a rectangular area of any 
dimensions within the limits of the physical page, 
usually associated with a form, subform, or print 
area. It can be used to define the print boundary 
and alternate print margins as well as interline 
spacing. This enables you to vary the interline 
spacing from one logical page overlay to the next 
within one physical page. 


It is helpful to view a logical page as an overlay on 
the physical page that varies in size from the 
physical page. You can specify a minimum of | 
and a maximum of 32 logical page overlays for the 
physical page. Figure 2-5 shows the placement of 
several logical pages on a single physical page. 


You specify the logical page dimensions and its 
location on the physical page on the Logical Page 
Menu. It may contain up to two forms. The 
forms may extend outside the logical page print 
boundaries as long as they remain within the 
physical page boundaries, but you cannot print 
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data to the area of the form which extends beyond 
the logical page boundaries. 


Logical Page Orientations 


When defining a logical page on the Logical Page 
Menu, you must specify one of the following page 
orientations: Landscape, Portrait, Reverse 
Landscape, or Reverse Portrait. When referencing 
a logical page programmatically the orientation is 
given in degrees. The initial page orientation (0 
degrees) is dependent in the direction of the paper 
movement through the output device and is, 
therefore, device dependent. The following table 
illustrates this relationship. 





LOGICAL PAGE ORIENTATION 


[LOGICAL PAGE MENU| 2680A | 2688A | 


{Landscape 0 270 







lPortrait 


fFReverse Landscape 






j;Reverse Portrait 


The logical page orientations rotate in increments 
of 90 degrees and are illustrated in Figure 2-6. 


You can compile multiple logical page orientations 
within an environment. 


You can also rotate the direction of data to be 
printed on the logical page as shown in Figure 2-8. 
The compiled rotation of the character font to be 
used to print the data must be included in the 
environment file and should agree with the 
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orientation of the logical page. Figure 2-7 shows 
the use of several character font and logical page 
orientations. 


Logical Page Numbers 


You specify the order in which you want logical 
pages printed on the physical page by assigning a 
number to the page when you define it on the 
Logical Page Menu. The Laser Printer prints 
(overlays) logical pages on each physical page in 
numerical order, from Oto 31. A physical page 
eject follows the highest ranked page and the 
numerical sequence is repeated on the next 
physical page. This cycle is maintained for the 
entire print job unless your application program or 
data file provides instructions to alter the compiled 
logical page hierarchy. 


Active and Inactive 
logical Pages 


You may choose to set logical pages as initially 
active or inactive and compile your environment. 
Setting them all inactive requires each logical page 
used to be activated individually by your 
application program or through commands within 
your data file. You specify whether the page is 
initially active or inactive when defining it on the 
Logical Page Menu. 


You can change the initial page status for the 
current print job using the PACTIVATEPAGE and 
PDEACTIVATE PAGE or the PSELECTPAGE 
programmatic intrinsics; or, the LPS Interpreter 
-ACTIVATEPAGE and .DEACTIVATEPAGE or 
. SELECTPAGE commands. 
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LOGICAL PAGE 1 LOGICAL PAGE 3 





PHYSICAL 
PAGE 
LOGICAL PAGE 2 LOGICAL PAGE 4 
Figure 2-5. Example of Logical Pages 
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Figure 2-6. Logical Page and Font Orientations 
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Figure 2-7. Logical Page Layout 
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HP 2680A INTELLIGENT PAGE PRINTER 
WORDS/DATA/GRAPHICS/WORDS/DATA/GRAPHICS 


Table Of Contents 


Line Printer Applications 








“General Ledger Report" - Creating more manageable 
line printer output. 






“Calendar Compiler Listing” - Line printer output 
in a portrait format. 






“General Ledger” - 2:1 and 4:1 reduction. High 
information density for maximum efficiency. 












"Calendar Compiler" - 2:1 and 4:1 reduction. High 
information density in portrait format. 





2680 Forms Applications 


“Marketing Composite” - Hard-to-read reports made 
easy with shading. 


"Routing Master" - Printing of forms and data 
simultaneously. 


“Purchase Order" - Replacing multi-part forms with 
custom duplicates. 


“Bar Code” - Bar code technology for state-of-the-art 
materials handling. 


"Form 1040" - Reproduction of complex forms is featured. 
Text and Graphics Applications 


"Memo" - Text, data and graphics features. Enhanced 
reporting of information. 


HP 2680A INTELLIGENT PAGE PRINTER 
SOIHdVUD/ VLVG/SCUOM/SOIHAVUD/VLVG/SGUOM 
UAINId AO¥d INAOITIAINI YO892 dH 





WORDS/DATA/GRAPHICS/ WORDS/DATA/GRAPHICS 


“Production Cost Reductions” - A typical technical 
documentation application. 





"Raster/Vector" - Graphics reproduced from raster and 
vector format. 





“HP and Non-HP Input" - The complete solution for 
electronic merging of words, data and graphics. 


HP 2680 Character Sets 











Listed alphabetically and by point size, characters 
per inch, lines per inch and proportional or 
non-proportional configuration. 










SOIHdAVUD/VLVG/SAHOM/SOIHd Vv UD/ VLVG/SCHOM 
UaINIdd JOVd INADITIALINI ¥O89T dH 







Figure 2-8. Actual Output 


Vertical Format Control 


The Laser Printer has the ability to print different 
character font sizes within a page. If font size 
differences are extreme, or you wish to redefine 
areas of the physical page for different font sizes, 
you can change the Vertical Format Control via 
the Logical Page Menu. Vertical Format Control 
(VFC) establishes the number of print lines on a 
page, and the amount of space to be placed 
between each line of print. 


IFS/3000 automatically generates an appropriate 
VFC for each logical page calculated on the font 
for VFC specified for the page or the environment, 
unless you specify otherwise. 





When. you design character fonts, or 
combine character fonts within an 
environment that contain line drawing sets 
or simulated graphics produced by 
character ordered symbols, the VFC must 
match the VFC specifications of the page. 
Otherwise, characters or symbols designed 
to meet end to end vertically, may not 
connect. If your special character fonts 
share the standard point size and spacing as 
the font for VFC used for the Logical Page 
VFC, your environment logical page and 
character font combinations should 
produce satisfactory results. 
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If your application requires a unique VFC, you can 
specify a custom-designed VFC on the VFC 
Selection Menu via the Logical Page Menu. You 
can also specify "No VFC", in which case the 
spacing between the lines depends on the cell 
height of the character currently being used for 
printing. In environments where there is a large 
range of point sizes, mixing point sizes on a single 
line of print may cause overlapping or irregular 
vertical spacing. 
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Graphics Terminology 


The HP graphics software includes of a number of 
subsystems which support the design of charts, 
graphs, drawings, and illustrations. Section 1 
summarizes how the HP graphics software provides 
document illustration capabilities. 


This section provides a brief review of the 
terminology you will encounter when selecting a 
program, saving the illustration you have created 
as a figure file, and converting a figure to a 
partitioned raster image for printing on the Laser 
Printer. 


These discussions also make references to the LPS 
Interpreter graphics commands and _ the 
Programmatic Interface graphics intrinsics which 
you will find in Sections 4 and 5 respectively. 


If you are using your text processor to call the 
graphics commands and intrinsics indirectly, you 
should also be familiar with any terminology and 
procedures specific to your processor. It may be 
that your processor provides commands which you 
embed within your data file that call the graphics 
intrinsics for you when you final your document to 
the Laser Printer. TDP/3000 and HPWORD 
provides extensive capabilities for integrating 
graphics by embedding commands within your text 
file that automatically call the graphics intrinsics. 
Refer to the Reference Manuals for these products 
for more information on editor/formatter assisted 
graphics integration. 
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Decision Support Graphics 
DSG/3000 


DSG/3000 is a graphics design subsystem that runs 
on the HP 3000. You may call the DSG/3000 
intrinsics programatically to produce charts using 
an application program; or, you may run the 
DSG/3000 menu-driven program, GRAPH, to 
design charts and graphs interactively. 


GRAPH enables you to enter tabular data to be 
converted to a chart or graph, make annotations 
within the graph format, and specify the fonts to 
be used for the annotations, headings, and labels. 


It enables you to print the chart to the terminal 
screen, a plotter, or the Laser Printer. When you 
specify the Laser Printer as the target output 
device on the Graphing Options Menu, GRAPH 
automatically converts the graph figure to a 
temporary partitioned raster image, loads the 
partitioned raster image into Laser Printer 
memory, prints the image, and purges it from 
printer memory. 


In addition, you may save a graph as a data file 
which can be modified or expanded; or save the 
graph as a figure in a figure file which can be 
converted to a partitioned raster image. A 
partitioned raster image is the format necessary to 
integrate your graph with a document on the Laser 
Printer at print time. 


To integrate a GRAPH figure file with a document 
at print time, you must initiate the figure to 
partitioned raster file conversion yourself. The 
PCONVERTFIGURE programmatic intrinsic or 
-CONVERTFIGURE LPS Interpreter command 
enables you to convert GRAPH figure files for the 


Laser Printer. The partitioned raster file created 
may be retained for future use without the need to 
reprocess the figure file, or it may be deleted to 
save memory space. 


For more information on designing charts, refer to 
the DSG/3000 Reference Guide, (part number 
32250-90001). 


HPEasyChart 


HPEasyChart is a graphics subsystem designed for 
the inexperienced user that runs on the HP 3000. 
The HPEasyChart interactive program, EZCHART, 
converts tabular data entered via a_ logical 
sequence of menus into a chart image. It enables 
you to print the chart to the terminal screen, a 
plotter, or the Laser Printer. When you specify 
the Laser Printer as the target output device on 
the Plot Chart Menu, EZCHART automatically 
converts the chart figure to a temporary 
partitioned raster image, loads the partitioned 
raster image into Laser Printer memory, prints the 
image, and purges it from printer memory. 


In addition, you may save a chart as a chart file 
which can be modified or expanded; or save the 
chart as a figure in a figure file which can be 
converted to a partitioned raster image. A 
partitioned raster image is the format necessary to 
integrate your chart with a document on the Laser 
Printer at print time. 


To integrate an EZCHART figure file with a 
document at print time, you must initiate the 
figure to partitioned raster file conversion 
yourself. The PCONVERTFIGURE programmatic 
intrinsic or .CONVERTFIGURE LPS Interpreter 
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command enables you to convert EZCHART figure 
files for the Laser Printer. The partitioned raster 
file created may be retained for future use without 
the need to reprocess the figure file, or it may be 
deleted to save memory space. 


For more information on creating charts with 
HPEasyChart, refer to the HPEasyChart Reference 
Guide, (part number 32109-90001). 


HPDraw 


HPDraw is an interactive graphics design 
subsystem that runs on the HP 3000. It provides 
the capability to create illustrations which include 
charts, graphs, drawings, figures, and text. You can 
design original illustrations; use charts or graphs 
saved in HPEasyChart or DSG/3000 as chart or 
data files; use any figure in an MPE figure file; or, 
create an illustration using any combination of 
these sources. HPDraw enables you to create, 
modify, and save your drawing through a logical 
sequence of menus and displays your drawing on 
the terminal screen. 


When ‘you specify the Laser Printer as the target 
output device on the Plotting Menu, HPDraw 
automatically converts the drawing to a temporary 
partitioned raster image, loads the partitioned 
raster image into Laser Printer memory, prints the 
image, and purges it from printer memory. 


In addition, you may save a drawing as a draw file 
which can be modified or expanded; save the 
drawing as a figure in a multi-figure file which 
can be recalled as a figure; or, save the drawing as 
a partitioned raster image in a partitioned raster 
file which is the format necessary to integrate your 
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drawing with a document on the Laser Printer at 
print time. You may not recall, enhance, or 
modify a drawing saved as a partitioned raster 
image. 


To integrate a figure in an HPDraw figure file 
with a document at print time, you must initiate 
the figure to partitioned raster file conversion 
yourself. The PCONVERTFIGURE programmatic 
intrinsic or .CONVERTFIGURE LPS Interpreter 
command enables you to convert HPDraw figure 
files for the Laser Printer. The partitioned raster 
file created may be retained for future use without 
the need to reprocess the figure file; or it may be 
deleted to save disc space. 


For more information on designing drawings, refer 
to the HPDraw Reference Guide (part number 
32108-90001). 


Figure Maker 


Figure Maker is an HP 3000 Graphics Utility 
which enables you to create a figure and save it in 
a multi-figure file, independent of any other 
graphics subsystem. 


The Figure Maker Utility may be operated 
interactively by supplying the utility commands 
and corresponding parameters at the "@" prompt. 
Or, you may supply an ASCII filename which 
includes predefined figure design specifications as a 
series of utility commands and parameters. 


The figure file you create with the Figure Maker 
Utility can be used in the same way as figure files 
created with any other HP 3000 graphics 
subsystem, including conversion programatically or 
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non-programatically to the partitioned raster 
image format for output on the Laser Printer. 


Appendix B describes the Figure Maker Utility. 


Figure 


Within the HP 3000 environment, a figure is a 
graphic image or "picture" which can be displayed 
on a graphics terminal screen, drawn on a plotter, 
or printed on a Laser Printer. The HP graphics 
software subsystems enable you to create these 
images. 


When creating a chart, graph, or drawing, a series 
of vector instructions is generated which contains 
the beginning and ending coordinates for each line 
of active (on) bits which make up the image. The 
terminal display and plotter image are drawn by 
activating the bits between these coordinates as it 
displays or plots the figure. 


If you wish to modify your figure at another time, 
you must save your figure as a chart, data, or 
drawing file depending on the graphic subsystem 
used to create the figure. When you save your 
figure in one of these file formats, the original 
data used to calculate the vector coordinates is 
saved. Each subsystem provides a means of 
retrieving the data file and modifying the 
information. 


If you do not want to modify the figure, you can 
specify the Laser Printer as the target output 
device and print the figure; or, you can save the 
figure in a figure file. 


Figure File 
The file code for a figure file is 1146 or FIG. 


When you save a chart, graph, or drawing as a 
figure, the vector coordinates are recorded for each 
line of the image and are stored in a figure file. 
The data associated with the initial creation of the 
figure is not saved. Since the figure file does not 
contain the original data, figures within the figure 
file cannot be modified. However, if you also 
saved the chart, data, or drawing file, you can 
modify the data, save it as a figure of the same 
name, and overwrite the existing figure. 


You can use HPDraw to include a figure as part of 
a drawing, but you cannot modify the figure itself. 
When you save a multiple-figure drawing in 
HPDraw as a figure, all coordinates are stored in 
vector format and are, therefore, unchangable. 


Since figure files contain the vector coordinates of 
an image and not the actual bit pattern of the 
image, the individual figures can be rotated and 
scaled when prepared for the Laser Printer. This is 
done by supplying the desired values for the 
imageheight, units, and imagerotation 
parameters of the .CONVERTFIGURE or the 
.PRINTFIGURE LPS Interpreter command, or the 
PCONVERTFIGURE or the PPRINTFIGURE 
programmatic intrinsic. Refer to the discussion on 
Figure Conversion and Rotation in this section. 


The Laser Printer does not have the capability to 
process the individual lines of coordinates stored in 
a figure file. Therefore, the figure file must be 
interpreted and converted to a dot pattern 
representing the figure before it can be accepted 
and stored in Laser Printer memory. 
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You would purge a figure file using the MPE 
: PURGE command. 


Partitioned Raster Image 


A figure in a figure file which is converted to a 
format that can be passed to the Laser Printer 
becomes a partitioned raster image. A partitioned 
raster image is the actual dot distribution of the 
entire figure fixed in size and orientation. Each 
figure must be converted individually and the 
partitioned raster image created is stored as a 
single partitioned raster image in a partitioned 
raster file. The partitioned raster image can be 
modified, rotated, or scaled using the 
PCONVERTRASTER command. An alternative would 
be to reconvert the figure file to a different size 
and rotation. 


It is helpful to view the partitioned raster image as 
the compiled format of a figure similar to an 
environment being the compiled format of fonts, 
forms, and logical pages. In each case, the figure, 
font, or form is passed to the Laser Printer as a dot 
distribution pattern that is only available for 
printing in the dot pattern format passed. 


Partitioned Raster File 


The file code for a partitioned raster file is 1114 
or RASTR. 


A partitioned raster file contains a_ single 
partitioned raster image. You convert a figure in 
a figure file to a partitioned raster image in a 
partitioned raster file using the CONVERTFIGURE 
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or PRINTFIGURE LPS Interpreter commands; or, 
the PCONVERTF IGURE or PRINTF IGURE 
programmatic intrinsics. 


You use a partitioned raster image stored in a 
partitioned raster file by specifying the 
rasterfilename with the .FLASHRASTER or 
.PRINTRASTER commands or the PFLASHRASTER 
or PPRINTRASTER intrinsics. 


You would purge a partitioned raster file using the 
MPE : PURGE command. 


Figure Rotation and Conversion 


When converting a figure to a partitioned raster 
image, you specify the rotation value as a 
parameter to the procedure. 


You can invoke the conversion procedure in a 
number of ways: 


e interactively, within the graphics subsystem 
you used to create the figure. 


© interactively, using the LPS Interpreter 
-CONVERTFIGURE or the .PRINTFIGURE 
command; or, by specifying a data file 
containing these commands to be processed by 
the LPS Interpreter. 


e programmatically, using the Programmatic 
Interface PCONVERTFIGURE or PPRINTFIGURE 
intrinsics in your application program. 


e indirectly using the TDP/3000 Formatter’s 
\ILLUSTRATION command or HPWORD?’s 
Figure Space function key. 
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The method you select will determine the affect of 
figure rotation in relation to its placement on the 
physical and logical page at print time. 


It is helpful to view the initial figure as being 
device dependent for the Physical Page. The same 
figure would be device independent for the Logical 
Page where the orientation is specified by the 
environment file. 


The initial orientation of a figure is specified as 
having 0 degrees of rotation when you create the 
figure. The upper left hand corner of the figure is 
used to establish the beginning pen location when 
printing the picture. Refer to figure 2-9 for the 
various partitioned raster image rotations. 


When you specify a rotation other than the initial 
orientation, the upper left corner vector is rotated 
in increments of 90 degrees from the upper left 
hand corner of the Physical Page as specified. All 
vector coordinates are then recalculated on the 
new beginning position. 


The height of the figure is also viewed in the 
figure’s initial orientation. Therefore, as you 
rotate a figure, your view of its height also rotates 
to maintain the initial top-to-bottom perspective. 


Your alternatives in invoking the conversion 
procedure have the following effects: 


e When you specifying the Laser Printer as the 
target output device within the graphic 
subsystem program and press (ENTER), the 
temporary partitioned raster image created is 
loaded into printer memory. It will be printed 
at the Physical Page orientation for the Laser 


Printer model specified. You can rotate the 
figure on the Physical Page if the subsystem 
enables you to provide alternate printing 
specifications. If you save your figure in a 
figure file you would use either of the 
following alternatives to rotate and convert 
your figure. 


The .CONVERTFIGURE command or the 
PCONVERTFIGURE intrinsic’s parameter strings 
require the default or a_ respecified 
imagerotation value. Rotation values are 
specified as 0, 90, 180, or 270 degrees of 
rotation on the Physical Page for the Laser 
Printer model specified. (See figure 2-9). 


The .PRINTFIGURE command or the 
PPRINTFIGURE intrinsic’s parameter strings 
require the default or a__ respecified 
imagerotation value. Rotation values are 
specified as 0, 90, 180, or 270 degrees of 
rotation on the Logical Page in the 
environment specified (See figure 4-3). Refer 
to the Logical Page Orientation discussion in 
this section. 


When you use the TDP/3000 Formatter’s 
\ILLUSTRATION command, you specify a 
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figure file name and figure name along with 
optional rotation, scaling, and positional 
parameters. Rotation values are specified as 
90, 180, or 270 degrees from the 0, or default 
orientation of the target Logical Page. The 
orientation of the Logical Page is established by 
the environment associated with the print job. 
The TDP/3000 £Formatter calls the 
PPRINTFIGURE intrinsic supplying the 
parameter values you specify. A temporary 
partitioned raster image is created, loaded in 
Laser Printer memory, printed on the target 
Logical Page, and purged from printer memory. 
Refer to the TDP/3000 Reference Manual 
(part number 36578-90001) to the review the 
Formatter \ILLUSTRATION command. 


e For information regarding use of figures in 
HPWORD refer to the Figure Space function 
key in the HPWORD Referencé Guide. 


For more information on the LPS Interpreter 
commands, refer to Section 4. For more 
information on the Programmatic Interface 
intrinsics, refer to Section 5. 
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Figure 2-9. Relationship of Height and Origin for Raster Image Rotations 
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Printing a Figure 


The LPS Interpreter . PRINTFIGURE command and 
the Programmatic Interface PPRINTFIGURE 
intrinsic perform a number of functions within a 
single procedure. A figure in a figure file can be 
rotated and scaled in relation to the target Logical 
Page, converted to a partitioned raster image, 
loaded in the Laser Printer, printed on the target 
logical page, and deleted from printer memory. 


You would use this procedure to print a figure that 
has not been previously converted to a partitioned 
raster image, and which is to be associated with a 
specific Logical Page. 


Refer to the above discussion on rotation and 
conversion, and to the procedure discussions in 
Sections 4 and 5. 


Printing a Partitioned Raster Image 


When a partitioned raster image in a partitioned 
raster file is designated for the Laser Printer, a 
copy of the partitioned raster image is loaded into 
the printer memory. This copy is classified as 
either permanent or temporary. 


A permanent partitioned raster image is loaded 
into the Laser Printer once, is available for 
printing as many times as you require, and is 
deleted from Laser Printer memory by you after 
you have printed the last copy required. You 
would use permanent partitioned raster images if 
you had to print the same image many times in a 
print job. You would purge the permanent 
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partitioned raster image to maintain space in the 
printer memory for other partitioned raster images 
you may have specified in that job. All partitioned 
raster images in the printer are purged 
automatically at the end of the job. 


A temporary partitioned raster image is loaded 
into the Laser Printer, printed once, and deleted 
from Laser Printer memory automatically after it 
has been printed. You would use temporary 
partitioned raster images if you wished to make a 
single print of each image where there are a large 
number of images. By automatically purging each 
temporary partitioned raster image, you maintain 
printer memory space for subsequent partitioned 
raster images. 


Since the partitioned raster image is a copy, its 
permanent or temporary classification refers to its 
status in Laser Printer memory and not to the 
status of the MPE partitioned raster file. 


Permanent and temporary partitioned raster 
images can be used simultaneously in a print job. 
You can specify up to 32 permanent or 64 
temporary partitioned raster images, but the 
combined total must not exceed 64 on any one 
Physical Page. You should note, however, that the 
actual number depends on the size of each 
partitioned raster image and is limited by the 
amount of memory available in the Laser Printer. 


You should also consider the amount of printer 
memory required to store your enviroment file. A 
copy of the environment file is loaded in printer 
memory first. This determines the available space 
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remaining for incoming partitioned raster images 
as the print job proceeds. 


Your use of the following LPS Interpreter 
commands or the Programmatic intrinsics 
determines the permanent or temporary status of 
the partitioned raster image. 


When you use the .LOADRASTER command or the 
PLOADRASTER intrinsic to copy your partitioned 
raster image into printer memory, the partitioned 
raster image is classified as permanent. It will 
remain in printer memory for the remainder of the 
print job, or until it is purged with the 
.DELETERASTER command or PDELETERASTER 
intrinsic. You print the partitioned raster image 
on the current Logical Page using’ the 
.PRINTRASTER command or PPRINTRASTER 
intrinsic. The parameter strings for these 
procedures enable you to specify the print position 
for the image on the Logical Page. 


The . FLASHRASTER command or the 
PFLASHRASTER intrinsic copies a temporary 
partitioned raster image into printer memory, 
prints it, and purges it from memory. The 
parameter string for this procedure enables you to 
specify the print position for the image on the 
Logical Page. 


It is important to remember that partitioned raster 
images created using the .CONVERTFIGURE 
command or the PCONVERTFIGURE intrinsic 
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maintain their association with the Physical Page 
orientation. Since you cannot rotate a partitioned 
raster image you should consider the orientation of 
the logical page on the physical page when 
converting figures for a specific print job. This 
will ensure that the rotation value you specify 
using the .CONVERTFIGURE command or the 
PCONVERTFIGURE intrinsic will result in a 
partitioned raster image that prints in the desired 
orientation on the target logical page. 


Positioning a Partitioned 
Raster image 


When printing a partitioned raster image, the x- 
and y-position parameters _— to the 
.PRINTRASTER and .FLASHRASTER commands, or 
PPRINTRASTER and PFLASHRASTER intrinsics 
refer to the vertical and horizontal coordinates on 
the logical page where the image is to be printed 
(see figure 4-3). 


These coordinates establish the beginning print 
position of the upper left hand corner of the 
partitioned raster image as rotated in relation to 
the upper left hand corner of the target logical 
page. This enables you to specify exactly where 
you want an image to print within a logical page. 
The values you specify here have no effect on the 
orientation of the partitioned raster image and 
refer only to the print position on the logical page. 





Overview 


This section provides information you should be 
familiar with when using the IFS/3000 interactive 
program to create a custom environment file. 


The environment file is the format necessary to 
associate your document formatting specifications 
with your data file. The Laser Printer accepts the 
environment file at the beginning of a print job, 
applies initially active specifications contained in 
the environment to the data file, and activates or 
deactivates alternate specifications based on 
instructions you associate with the data file as the 
print job progresses. 


Some of the specifications within the environment 
file can be developed by using data such as fonts or 
forms stored in files created by other software 
systems. The process of assimilating these 
components, providing a means of identifying and 
activating them individually, and converting them 
to a single file that can be accepted by the Laser 
Printer is the function of the IFS/3000 program. 


Part one of this section reviews the requirements, 
procedures, and conventions you need to know to 
initiate an interactive session with the program on 
your terminal. 


Part two provides a Menu Map of the IFS/3000 
program, presents each menu in the logical 
sequence established by the Main Menu procedures, 
reviews the operation of the function keys for each 


menu, reviews the data entry fields and the effect 
of the field operation on the information you 
specify. 


Since IFS/3000 enables you to combine 
components created with other subsytems, all file 
references you specify must be accessible to the 
program. In addition, the formatting 
specifications must be consistent with the 
hardware specifications of the target output 
device. In order to assist you when inconsistencies 
occur, a series of warning and error messages will 
be issued by the program. 


Part three of this section presents the error 
messages, their general meaning, and suggested 
courses of action. 


Requirements for Running 
IFS/3000 


IFS/3000 requires a CRT terminal connected to an 
HP 3000 host computer. A graphics terminal is 
not required as the components of your 
environment specifications’ reside as disc files 
within the MPE file system. IFS/3000 accesses 
these files but does not display their contents on 
your terminal screen. 


In addition, your terminal must support 
VPLUS/3000 in order to display the IFS/3000 
menus which are the main communication format 
for your session. 
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IFS$/3000 Menu Conventions 


IFS/3000 will present instructions on your 
terminal screen along with available procedures 
and areas for entering data and specifications. 
Each logical set of procedures will appear in a 
format called a menu. 


Number 
Name 


A - Choice A 
B - Choice B 
C - Choice C 
D - Sample specification response 





Number 


N= =©Sample default value? Y/N 





Number -OR- 





Each menu will use the same general conventions 
so that you can expect to find the information 
presented in a consistent format. 


You use the terminal keyboard to type data or 
specifications on an IFS/3000 Menu. The areas 
reserved for entering data are called 
fields. Unprotected fields are the hig} 
areas in the midsection of the menu. 







Name 








Figure 3-1. IFS/3000 Menu Conventions 
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The cursor is positioned by IFS/3000 at the first 
unprotected field available for data input. Field 
instructions or a list of available specifications will 
appear directly above, or adjacent to each data 
entry field. The field instruction tells you what 
information should be entered in the field. 


Some fields only provide enough space to enter a 
few characters representing your selection from 
the choices available. You may type as many 
characters as will fit within the unprotected 
; but you do not have to 
fill the entire field. You can use either the 
key or the cursor control keys to move the 
cursor to the next field. 





Not all of the areas are intended for your use. For 
example, the menu banner line, the instructions, 
and the function key labels are protected fields. 
You cannot overwrite or add data in these fields. 


When you press the key on your terminal 
keyboard, the information entered on the menu is 
issued to the computer. At this time the IFS/3000 
program may issue Status, Warning, or Error 
Messages which will be displayed in the menu 
banner window. These messages generally indicate 
that the program performed the menu operation 
successfully, or encountered difficulty in one of 
the following areas: 


e the program could not find or access the 
filename entered on the menu, or a designated 
component within the file is not available as 
specified. 


e the program found inconsistencies between the 
specifications you entered on the menu and the 


USING IFS/3000 INTERACTIVELY 


target output device limitations, or other 
specifications you have entered previously. 


e the program encountered difficulty or failed to 
perform the specified operation. 


The menu remains on the screen for you to review 
or modify. IFS/3000 only proceeds to another 
menu when you press and there have been 
no changes to the current menu since you last 
pressed the key, or when you press an 
appropriate function key. 


Using the Terminal Keyboard 


Unless all terminals in your area are identical you 
will find that some keyboards may have different 
keyboard arrangements. Take a few moments to 
become familiar with your keyboard. The 
IFS/3000 program enables you to use some of the 
standard keys as they are labeled. Other keys are 
reassigned by the program to enable you to move 
from one location in the program to another. 
When you are comfortable with your keyboard 
arrangement, you will have a much more efficient 
IFS/ 3000 session. 


There are five key groups on the keyboard which 
you will be using as follows: 


The special function keys. 
The terminal control keys. 
The character set keys. 
The display control keys. 
The field edit keys. 
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The Special Function Keys 


The function keys are labeled f1 through f8 and 
are located on the upper half of your keyboard. 
On some terminals they are spread across the top; 
on others they are placed in two rows of four keys 
each as follows: 


CAL) C#2 9) C43 Cs 
C4s) C#e) CAr) C#s) 


Every menu has eight function Key Labels along 
the bottom. This kK specifies what 
operation can be performed if you press the 
corresponding special function key on your 
keyboard. Some function keys change labels with 
each menu change. Experimenting with the 
function keys is the best way to become 
comfortable with the logical sequence of IFS/3000 
Menus and how the function keys operate. 


Any data typed on a menu is not issued to 
the computer until you press (ENTER). If 
you press a function key to move to 
another menu before you press (ENTER), the 
current data will be lost. 





The Function Key Layout in Figure 3-2 and the 
IFS/3000 Menu Map in Figure 3-3 will guide you 
through the IFS/3000 program. Below are 
definitions for those functions which you will see 
frequently. 
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Key Label 














Function 


There are eight function key 
labels along the bottom of each 
menu. A blank label highlight 
indicates that no function has 
been assigned to the function key 
for that menu. 


This will be the function of C76 _) 
on every menu. If the 
TERMINAL RESET key - is 
accidentally pressed or in case of 
a power failure, press Refresh and 
the screen will be redisplayed 
with the last data or information 
that was issued to the computer 
when you pressed (ENTER). Any 
data typed on the menu before 
using the key is not 
available and will not be 
redisplayed. 


This will be the function of 
on every menu _ except the 
Environment File and Main 
Menus. You may return to the 
Main Menu from any menu with 
this function key. You can then 
specify another operation or exit 
the program from the Main 
Menu. 


If you change your mind when 
entering data on a menu or after 
you have pressed the key, 
press to delete the data 
and return to the Main Menu. 


iIFS/3000 Function Key Labels 


IFS/3000 FUNCTION KEY LABELS 






MENU NAME C#¥i) C¥20) C43) CfA) C#8) Ce) C47) Cea) 


ENVIRONMENT 
MAIN 
INITIALIZE 
COPY 


PHYSICAL 
PAGE 


MULTI-COPY 
FORMS 


CHARACTER 
| FONT 


| LOGICAL 
| PAGE 





LOGICAL 
PAGE FORMS 


| VERTICAL 
| FORMAT 





Figure 3-2. IFS/3000 Function Key Labels 
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The Terminal Controi Keys 


There are four keys in this group which will effect 
your IFS/3000 session. They are the BLOCK 
MODE, ENTER, (BREAK), and RESET TERMINAL 
keys. Normally, the BLOCK MODE key is used 
only with the HP2640B terminal. The key 
may be iocated in the Character Set Group on 
some terminal keyboards. You should not need to 
use the key and RESET TERMINAL keys 
unless recovery procedures are required. The key 
functions are defined as follows: 


BLOCK Pressing this key puts the terminal in 

MODE block mode. This enables you to type 
all data required for a specific menu 
and make modifications before it is 
issued to the computer. IFS/3000 
automatically puts terminals in 
BLOCK MODE, except the HP2640B 
where it displays a message asking 
you to depress the BLOCK MODE 
key. 


(ENTER } Pressing this key sends all data you 
have typed on a menu to the 
computer. It is your only means of 
issuing data to the IFS/3000 
program. Any data you type on a 
menu will be lost if you leave the 
menu before pressing the enter key. 
Once you press (ENTER), the program 
processes your data and may issue 
Status or Error Messages. 


If you accidentally press this key 
while in session, you will be exited 
from the IFS/3000 program. You 
can recover with the following steps: 
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1. Press the RESET TERMINAL key. On an 
HP2645A, HP2647A/F, HP2648A,_ or 
HP2640B; press the RESET TERMINAL key 
rapidly, twice. On the HP264O0B, also press the 
BLOCK MODE key to return to character 
mode. On an HP262X terminal, press the 
CTRL (control) and SHIFT keys while pressing 
RESET TERMINAL. 


2. Press to get the MPE colon prompt (:). 


3. Press the ESC (escape) key at the left of the top 
row of the character set group. Then press the 
colon (:) key to display what you are typing 
(echo) on the terminal screen. 


4. Type the word resume and press the 
key. The message "READ PENDING" will be 
displayed on your screen. On an HP2640B 
terminal, press the BLOCK MODE key. 


5. Press the f6 function key to redisplay 
(REFRESH) the current menu. On an HP262X 
terminal, press the USER KEYS key before 
pressing REFRESH. 


These procedures can also be used to recover from 
a power failure or from your terminal being 
turned off while you are in session. 


The Character Set Keys 


This group includes the standard typewriter 
alphanumeric keys which you use to enter data 
values, names, and specifications. In addition, you 
may use the (RETURN), CTAB), SHIFT, and 
BACKSPACE keys to control the cursor. The 


cursor is the blinking underscore on the terminal 
screen which indicates the position where a 
character you type on the keyboard will appear on 
the screen. 


The key moves the cursor to 
the beginning of the next line 
available in the current unprotected 
field. It will move to the next field 
only if it is at the end of the current 
field. 


The key does not issue data 
to the computer. You would use the 
key to issue data to the 
computer. 


TAB The key moves the cursor 
from its current position to the 
beginning of the next unprotected 
field. With each subsequent 
the cursor moves to the beginning of 
each field, from left to right, on each 
line where there is more than one 
unprotected field. A from 
the last field on a menu will 
reposition the cursor at the beginning 
of the first unprotected field at the 
top of the menu. In addition, holding 
down the CNTL (control) key while 
pressing the key will move 
the cursor backwards through the 
previous field positions. For the 
HP262X series of terminals, the 
SHIFT key is used with the 
key to return to the beginning of the 
previous fields.) The reverse TAB 
procedure is not available on the 
HP2640B. 


USING IFS/3000 INTERACTIVELY 


The SHIFT key performs the standard 
typewriter upper case shift. In 
addition, on 262X terminals the 
SHIFT key acts as a control key by 
reversing the forward motion of the 
key cursor control function, 
where (SHIFT)/ moves the 
cursor to the previous unprotected 
field. 


The BACKSPACE key moves the 
cursor back one character. 


The Display Control Keys 


This group of keys can be used to move the cursor 
and to clear data from the unprotected fields. 
When you use the cursor positioning keys, you can 
inadvertently type outside of the limits of an 
unprotected field. When this happens, the 
program will automatically tab to the next 
unprotected field and continue the typing display. 
The keys in this group are defined as follows: 
CLEAR Clears all data in all unprotected 
fields from the current position of 
the cursor to the last field of the 
menu. 


CNTL/ Clears the data from all lines within 

CLEAR the unprotected field at the cursor 

DISPLAY _ position. Data in other unprotected 
fields is not cleared. 


CURSOR Moves the cursor back one character, 
LEFT or continuously without changing any 
existing characters. 
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CURSOR 
RIGHT 


CURSOR 
UP/DOWN 


CURSOR 
HOME 


CNTL/ 
CURSOR 
HOME 


Moves the forward one character, or 
continuously without changing any 
existing characters. (The SPACE 
BAR would clear existing characters. ) 


Moves the cursor up or down one line, 
or continuously without changing any 
existing characters. 


Moves the cursor to the beginning of 
the first unprotected field on the 
menu. 


Positions the cursor after the last 
unprotected field on the menu. On 
an HP262X terminal, use the SHIFT 
and CURSOR HOME keys. 


The Field Edit Keys 


The keys in this group enable you to insert or 
delete characters at the cursor position in an 
unprotected field as follows: 
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INSERT 
CHAR 


DELETE 
CHAR 


After you press this key, any 
character you type will be inserted in 
front of the character at the cursor 
position. If the field is full, inserting 
characters will push the rightmost 
characters beyond the field limits and 
they will be lost. You turn the 
INSERT CHAR function off by 
pressing the INSERT CHAR key a 
second time to return to normal 
mode, where any character typed 
replaces the character at the cursor 
position. The INSERT CHAR key 
should always be turned off 
immediately after use to avoid 
accidentally inserting data. 


Each time you press this key, you 
delete the character at the cursor 
position. All subsequent characters 
in the field move one space to the 
left, creating blanks in the rightmost 
positions of the field. You do not 
need to turn the DELETE CHAR key 
off as it operates only when pressed. 


Using IFS/ 3000 Menus 


When you log on and :RUN IFS.PUB.SYS you 
enter the program at the Environment File Menu. 
There are ten menus in the IFS/3000 program as 
follows: 


Environment File Menu 

Main Menu 

initialize Menu 

Physical Page Menu 
Multi-Copy Forms Menu 
Logical Page Menu 

Logical Page Forms Menu 
Vertical Format Control Menu 
Character Font Menu 

Copy Menu 


Once you supply a valid environment file name on 
the Environment File Menu, you _ will 
automatically be presented with the Main Menu. 


The Main Menu lists all operations you can 
perform when creating or modifying an 
environment file. Subsequent menus in the 
program will only be presented if they support the 
task you select on the Main Menu. 


The Initialize Menu enables you to use an existing 
environment’s specifications as the starting point 
for creating a new environment. 


The Physical Page Menu enables you define the 
physical page size. It also provides the menu path 
to the Multi-Copy Forms Menu where you specify 
forms to be used to simulate carbon copy output or 
multiple-copies of the physical page. 


USING 1FS/3000 INTERACTIVELY 


The Logical Page Menu enables you to specify 
alternate page layouts for the physical page. It 
also provides the menu path to the Logical Page 
Forms Menu, where you specify a form residing in 
a forms file to be included in the logical page 
layout. Or, you may proceed to the Vertical 
Format Control Menu to specify vertical line 
spacing unique to the logical page. 


The Character Font Menu enables you to specify 
fonts residing in a character font file which are to 
be included in the environment. 


The Copy Menu enables you to copy all or part of 
an existing environment into the environment you 
are creating or modifying. 


Any data you enter on any menu in the program is 
only issued to the computer when you press 
(ENTER). If you use any function key before you 
use the key, the data just typed will be 
lost. When you press (ENTER), the status of the 
operation on the field data will be acknowledged 
by a message in the banner, or a bell. 


The Environment File Menu enables you to exit 
the program with the (/a4_) function key. Once 
you proceed to the Main Menu, you must return to 
the Main Menu to specify that you wish to exit the 
program. If you have not compiled the current 
environment file, a warning message will be issued 
and you will be asked to repeat your exit 
instruction in order to exit the program. 


On all menus except the Environment File Menu, 
you may return to the Main Menu using the 
Cf7_) function key. Figure 3-3 provides a 
Menu Map of the IFS/3000 program. 
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The IFS/3000 Menu Map 


ENVIRONMENT 
FILE 


CHARACTER LOGICAL PHYSICAL 
INITIALIZE FONTS PAGES PAGE 


LOGICAL 
PAGE 
FORMS 


MULTI—COPY 
FORMS 





Figure 3-3. The IFS/3000 Menu Map 
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USING IFS/3000 INTERACTIVELY 


Log-On and Run IFS/ 3000 


Before you can run IFS/3000 you have to complete several basic steps. If you are using a 264X series 
terminal, you should make sure that the REMOTE key, on the second row from the top, is depressed. 


The next step is to inform the system that you wish to start working. To do this, you must identify yourself 
with a user name and account name. 


First, press the key on your keyboard until a colon (:) appears on the screen. 
Type the following at the colon, substituting your user and account names: 
Space Period 

:HELLO username .accountname 
Press the key. After a brief pause, the system acknowledges your hello with a message. 

HP3000 / MPE IV C.DQ.20. SUN, JAN 30, 1983, 2:51 PM 
When a colon (:) appears following the message, the system is ready to accept your instruction to run the 
IFS/3000 program. At the colon, type: 

:RUN IFS.PUB.SYS 


Press the key. The first message you will see will identify the version of IFS/3000 and VPLUS/3000 
available on your system displayed as follows: 


IFS/3000 (A.02.01) HP36580 (c) COPYRIGHT Hewlett-Packard Co. 1983 
V/3000 (B.03.20) 


After a brief pause, the Environment File Menu will be displayed. 
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The Environment File Menu 





Environment File 








Figure 3-4. Environment File Menu 


The Environment File Menu is the first menu in 
the IFS/3000 program. 


You use this menu to access an existing 
environment file, or create a new environment 
file. When you specify a valid filename and press 
(ENTER), the Main Menu will be presented where 
you indicate the operation you wish to perform. 
You can return to this menu by pressing 
on the Main Menu. 
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Function Keys 


The function keys used on this menu are: 


Once you have typed the 
environment file name you wish 
to access or create, press the 
key to issue the filename 


to the computer. IFS/3000 will 
issue status messages if the file 
does not exist as specified, or the 
Main Menu wiil be presented. 





Press C6) to redisplay the 
terminal screen. 





Press to EXIT the 
IFS/3000 program. 


Field Discussion 


The Environment File Menu provides a single data 
entry field to specify a filename. You enter the 
environment filename using standard MPE File 
System naming conventions, where the filename 
may have up to 8 characters, and can be any letter 
followed by any letter or number. If the file 
resides in a group other than the sign-on group, 
you must specify a groupname and accountname. 
You may also specify a lockword if this form of 
security applies to the file. 


If you are creating a new environment file, it will 
reside in the sign-on group and account. 


If you used all of these file designation conventions 
the field data entry would appear as follows: 


Environment File 





The IFS/3000 program checks to see that the 
filename specified exists, and that it is an 
environment file. If the file does not exist as 
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specified, a status message will be issued to the 
banner window indicating that: 


@ The filename does not meet MPE filename 
conventions as specified. 


e The file does not reside in the group and 
account specified, where the group and account 
is different from the group where the program 
is being run. 


® You cannot access the file in the group and 
account specified due to security violations. 


e The file specified is not an environment file. 


OR, if the filename does not exist in the current 
group, you will be asked if you wish to create a 
new environment file. 


e If you do not want to create a new 
environment file, you can change the 
environment filename and enter it again. This 
process can be continued until you enter a 
filename which meets the IFS/3000 and MPE 
requirements and is accessible as specified. 


e If you want to create a new environment file 
with the name specified, press as 
requested. 


e OR, press to EXIT the IFS/3000 
program. 


Once you supply a valid filename and press 
CENTER), the Main Menu will be presented. 
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The Main Menu 


Initialize environment 


Character fonts 
Logical pages, forms and VFCs 
Physical page and multi-copy forms 
Copy from another environment 
Delete character font 
Delete logical page 


Compile environment 
Exit 


Font/Page number 


Figure 3-5. 


The Main Menu is the control menu for all 
IFS/3000 operations. It lists the operations you 
can use to review, modify, or create an 
environment file. 


There are three ways to get to the Main Menu: 
1. The Main Menu is automatically displayed 


after the Environment File Menu. 
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Comarea space required 
words. 


Character font name 


The Main Menu 


2. 


Pressing the function key, C#7_), 
takes you to the Main Menu at any time, 
except from the Environment File Menu. 





When you press twice on any menu 
which you accessed from the Main Menu, you 
will be returned to the Main Menu. An 
exception to this is where you have specified 


the option to proceed to a subsequent menu 
path from the current menu. 


You may return to the Environment File Menu 
using the | function key, or exit the 
program by entering E. However, once you create 
or modify any environment specifications on 
subsequent menus, you must complete the 
operation by compiling the new or modified 
specifications for the environment file. A warning 
message will be issued before you are allowed to 
leave the Main Menu if the environment file is not 
in the compiled state. Your environment file must 
be compiled to be successfully associated with a 
data file and be accepted by the Laser Printer. 





Function Keys 
The function keys used with this menu are: 


Once you have typed your 
operation selection and any 
associated data in the menu fields, 
press the key to issue 
your instructions to the 
computer. IFS/3000 will issue 
status messages to the menu 
banner if it has difficulty 
performing the operation; OR, a 
menu which supports. the 
specified operation will be 
presented. 


Press (fA6_) to redisplay the 
terminal screen with any data 


entered using the key. It 
is useful when the terminal is 
inadvertently turned off or reset. 








Press when youare done 
with the current environment file 
and wish to return to. the 
Environment File Menu = and 
specify another environment file. 


Field Discussion 
There are five data entry fields on the Main Menu. 


The Selection Field and the Device Field are 
required fields. A warning message will be issued 
to the message banner if you specify a selection 
code not listed, leave the selection field blank, or 
make a selection without specifying the target 
output device. If you are reviewing or modifying 
an existing environment file, the device will 
default to the device specified in the existing 
environment. 


i. The Selection Field 


Sele tion 





The first field on the Main Menu is the Selection 
field. The alternate selections provide the menu 
path to all operations which can be performed on 
an environment file. You enter a one or two letter 
code for the operation you wish to perform. If you 
do not enter a selection, or you specify an 
erroneous one, and press (ENTER), an error message 
is displayed in the menu banner. To proceed, you 
either enter a valid selection, also specify a device 
if an existing file default doesn’t apply, or press 
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to return to the Environment File 


Menu. 


Your 


alternate selections for this field are defined 


as foliows: 








Initialize environment 


This selection along with a new environment 
device number will display the Initialize 
Menu. You would not use this option if you 
specified an existing environment file on the 
Environment File Menu. Trying to initiate 
another set of basic specifications using 
another environment file on the Initialize 
Menu while in an existing file will destroy 
the current specifications. 


You could use this option to initialize a new 
environment by _ starting with the 
specifications in the file you enter on the 
Initialize Menu. 


Refer to the Initialize Menu discussion which 
follows in this section. 


Character Fonts 


This selection along with an existing default 
or new environment device number will 
display the Character Font Menu. You use 
this menu to review or modify the character 
fonts included in an existing environment. 
OR, you use this menu to identify a character 
font to be added to the environment. In 
order for a character font to be available for 
a print job, it must be included in the 
environment in the size and rotation desired. 
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You can enter up to 32 different sets of 
character font specifications. You can go 
directly to a character font by also entering 
its numerical identification number in the 
optional Font/Page number field or its 
name in the Character Font Name field on 
this menu. If you do not specify a font 


Refer to the Character Font Menu discussion 
which follows in this section. 


Logical pages, forms and VFCs 


This selection along with an existing default 
or new environment device number will 
display the Logical Page Menu. You use this 
menu to review or modify the logical pages 
included in an existing environment. OR, 
you use this menu to define a logical page to 
be added to a new or existing environment. 
You would also use this menu path to access 
the Logical Page Forms Menu where you 
associate up to two forms in a forms file with 
a logical page. And, proceed to the Vertical 
Format Control Menu to specify the vertical 
line spacing unique to a logical page. 


You can enter up to 32 different sets of 
logical page specifications. You can go 
directly to a logical page by also entering its 
numerical identification number in the 
optional Font/Page number field on this 
menu. If you do not specify a logical page 





the environment, the program starts with the 
lowest logical page, usually 0 (zero). 


Refer to Logical Page, Logical Page Forms, 
and Vertical Format Control Menu 
discussions which follow in this section. 


Physical page and multi-copy forms 


This selection along with an existing default 
or new environment device number will 
display the Physical Page Menu. When 
creating a new environment from scratch, 
you would use this menu to specify the paper, 
and therefore, physical page size for the 
environment. You can also specify the 


ED-number of the initial primary and 
secondary character fonts for the 
environment. And, you can specify if 
multiple copies of the physical page are to be 


printed when the print job commences. 


This menu provides the menu path to the 
Muliti-Copy Forms Menu where you specify 
pairs of forms in a forms file to be used to 
simulate carbon copy output. 


Refer to the Physical Page and Multi-Copy 
Forms Menu discussions which follow in this 
section. 


Copy from another environment 


This selection along with an existing default 
or new environment device number will 
display the Copy Menu. You use this menu 
to copy all or selected parts of another 
environment file into the current 
environment file. This alternate differs 
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from the Initialize selection in that you may 
select the parts you wish to use. 


Refer to the Copy Menu discussion which 
follows in this section. 


Delete character font 


This selection along with an existing default 
device number AND the character font 


D-number entered in the Font\Page 


number field, or optional character font 
name entered in the Character font name 
field, perform the operation directly from 
the Main Menu when you press (ENTER). 
The character font specifications will be 
deleted from the environment and are no 
longer available through the Character Font 
Menu. The compiled parts of the deleted 
character font will be deleted when you 
recompile the environment. A bell signal 
will indicate the operation is complete and 
the Font/Page number, and 
| field entries 
will be returned to blanks. A status message 
will be issued if the font specified is invalid 
or cannot be found. 





The recompile operation must be selected as a 
separate operation as discussed below. 


Delete logical page 


This selection along with an existing default 
device number AND the logical page 


iD-number entered in the Font\Page 


number field perform the operation directly 
from the Main Menu when you press 
(ENTER). The logical page specifications will 
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be deleted from the environment and are no 
longer available through the Logical Page 
Menu. The compiled parts of the deleted 
logical page will be deleted when you 
recompile the environment. A_ bell signal 
will indicate the operation is complete and 


to blanks. A status message will be issued if 
the logical page specified is invalid or cannot 
be found. 


The recompile operation must be selected as a 
separate operation as discussed below. 


Compile environment 


This selection along with an existing default 
or new environment device number perform 
the compile operation directly from the Main 
Menu when you press (ENTER). You would 
use this operation when you are satisfied 
with the specifications defined for an 
environment and you wish to prepare it for 
use by the Laser Printer. You would also use 
this operation to recompile an environment 
you have modified. You have the option to 
recompile all components of the modified 


inquiry field. If you do not want to 
recompile everything, press without 
changing the default. 


If problems are encountered during the 
compile operation, warning or error messages 
are displayed in the banner window. 
Warning messages indicate the specified part 
was compiled or retained as previously 
compiled, but a condition exists in the 
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compiled format which could affect its use. 
Since warning messages do not stop the 
compile, each subsequent warning replaces 
the preceeding one. You must note each 
message as it occurs, or recompile the 
environment again and watch the warnings 
as they are displayed. 


An error stops the compile operation and a 
corresponding error message is displayed. 
The third part of this section lists error 
messages, their meaning and the suggested 
action. 


You can return to the part in error to make 
modifications by selecting one of the 
alternate operations which will enable you to 
proceed to the menu containing the 
specifications. If the error is due to a 
component file outside of IFS/3000, you may 
exit the program to modify the file, and a 
warning message will be issued that the 
current file needs to be compiled. 


When the environment has compiled 
successfully, the message: 





is displayed in the banner window. The 
amount of space required for’ the 
environment COMAREA which is used by the 
Programmatic Interface intrinsics is displayed 
as follows: 


Comarea space required 
number words 


Exit 





This selection indicates that you wish to 
EXIT the program. If the environment file 
was modified and not recompiled or is new 
and needs to be compiled, the program will 
clear the selection and issue a warning 
message and an instruction. If you wish to 
exit without compiling the environment, 
reselect and press (ENTER). You will be 
returned to the MPE operating system as 
foliows: 








END OF PROGRAM 


The version number of IFS/3000 is also 
displayed above End of Program. 


NOTE 


The uncompiled environment remains 
unavailable for use with a data file or the 
Laser Printer. Any unchanged parts 
previously compiled remain compiled. You 
can run IFS/3000 at any time to complete 
the compile or recompile operation. 


2. The Device Field 


Device 





The Device Field is a required field. When 
creating a new environment, you must specify the 
target output device in this field. IFS/3000 uses 
the device number when performing the selected 
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operation to determine if the specifications for the 
physical page, all logical pages, and all character 
fonts are consistent with the target device 
limitations. 


Once the device field is specified, it remains device 
specific. When you_ specify an_ existing 
environment on the Environment File Menu, the 
field will default to the device associated with the 
existing file. The device model number will 
appear in this field and you replace it only if you 
are converting the entire environment to an 
alternate device. 


Environments are device specific. All components 
within an environment are compiled using the dot 
pattern and density specific to the Laser Printer 
Hardware specified as the device. Most of the 
components of the environment, with the 
exception of some forms, are also device dependent 
when created. Hewlett-Packard supplied fonts 
and environments are also device specific. 


If you plan to convert an existing environment, it 
is suggested that you consider the availablility of 
the device dependent components for the new 
device. Refer to Sections 1 and 2 in this Reference 
Guide to review the characteristics of device 
dependent components. Appendix H describes the 
IFS/3000 Merge Utility which you can use to store 
device dependent fonts in a single character font 
file. Appendices C and D lists Hewlett-Packard 
supplied environments and fonts respectively. 
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The format for data entry in this field is as 
follows: 





The HP 2680A Laser printer is a 
tractor-feed system printer which 
prints 180 dots per inch. 


The HP 2688A Laser Printer is a 
single sheet office printer which 
prints 300 dots per inch. 








When you’ have specified an 
existing environment on the 
Environment File Menu, the device 
associated with the environment 
becomes the default for this field. 
This field cannot be blank when a 
new environment is specified. 


3. The Font/Page Number Field 





Font/Page number 


You access the specifications for a specific font or 


EEISSHEEE 


Page or Character font menu if you need to review 
existing font or logical page numbers. 


wee you are deleting a ~~ page by specifying 


in n this field. 


When you are deleting» a character font by 
specifying BG 

is required in this field, or its name is required in 
the Character Font Name field. 
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When you are using the delete operation and 


specify the E§-number in this field and press 


(ENTER), no other menus are required or presented. 
The program issues a_ status message or 
acknowledges a successful deletion by returning 
the filed to blanks and sounding a bell. 


This field is optional if you entered | 
Selection field. You can use this f 
specific character font or logical page that you 
want to add, modify, or review. IFS/3000 displays 
either the Character Font or Logical Page Menu 
with exising specifications, or as a blank menu to 
enter new specifications. 





4. The Character Font Name Field 


Character font name 





You use the Character Font Name field only if you 
© or G8 in the Selection field. It is not 





necessary to use both the character font 
¥6-number and the character font name. Either 


of these is sufficient to select the specific character 
font you want to work with or delete. However, 
one or the other is required when you are using the 
delete operation. 


You can use this field to select a specific character 
font that you want to add, modify, or review. 
IFS/3000 displays the Character Font Menu with 
exising specifications, or as a blank menu to enter 
new specifications. 


5. The Recompile Everything? 
Field 


This field contains the default value § (=no). If 


you use the default value, the program compiles 
only those specifications which are new or have 
been modified since the last compile. The logical 
page and physical page are exceptions as they are 
always recompiled. 


If a form associated with a logical page was 
modified using IDSFORM, IFS/3000 detects the 
change to the form even though the logical page 
specifications were not changed on the Logical 
Page Menu. Also, if a character font has been 
modified using IDSCHAR, IFS/3000 detects the 
change even though the character font 
specifications where not changed on the Character 
Font Menu. 
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Since IFS/3000 detects these changes, it will 
automatically recompile the associated 
specifications. 


However, if you modify a character font that is 
referenced on a form created using IDSFORM, 
IFS/3000 WILL NOT detect the change and thus 
WILL NOT recompile the form. To recompile the 
form, you must either change this field to ¥ to 
recompile everything, or access the form using 
IDSFORM and modify the field containing the 
character font in question. Once this field has been 
accessed, IFS/3000 recognizes a change has been 
made and will recompile it. 


For more information on forms design, refer to the 
IDSFORM Reference Guide (part number 
36581-90002). 


To recompile all specifications in the environment, 
change the default in this field to ¥ and press 
(ENTER). Status and Error messages will be issued 
to the menu banner. Large environments may 
take considerable time to recompile if this option is 
selected. 
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WARNING: anything already in this file will be lost 


= HP defined environment 


R - Regular line printer 
T - Typewriter, 10 pitch 
E - Typewriter, 12 pitch 
D - Document 
L - Landscape 
P - Portrait 

| Reduction (For 2680A only) 
2-2tol 
4-4tol 

~OR- 


Another environment 

















Figure 3-6. The Initialize Menu 





If you enter J. in the Main Menu Selection field, 
the Initialize Menu is displayed. You have the 
option of using this menu when you are creating a 
new environment file. It enables you to use 
specifications in an existing environment file as the 
initial specifications for the new environment. 
This provides the advantage of not having to enter 
all of the specifications necessary to define a new 
environment using the Physical Page Menu. 
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WARNING . 





You WOULD NOT use this menu if you have 
already specified an existing environment file on 
the Environment File Menu. Trying to initiate 
another set of basic specifications using the 
Initialize Menu when in an existing environment 
will destroy the current specifications, 


Function Keys 


The function keys used with this menu are: 











Once you have typed your 
environment selection in a menu 
field, press the key to 
issue your instruction to the 
computer. IFS/3000 will issue 
status messages to the menu 
banner if it has difficulty 
accessing or copying the 
environment. OR, the Main 
Menu will be displayed for you to 
continue with additions or 
modifications to the copied 
specifications. 


Press (6 _) to redisplay the 
terminal screen with any data 


entered using the key. It 
is useful when the terminal is 
inadvertently turned off or reset. 


Press to return to the Main 
Menu before you have entered an 
environment selection. 


Press to cancel the 
environment selection you have 
typed on the menu and have not 
entered. 


Field Discussion 


There are three data entry fields on the Initialize 
Menu. You must specify either the HP Defined 
Environment or a name in the Another 
Environment field in order for IFS/3000 to 
locate, access, and copy the specifications in an 
environment file. The fields are defined as 
follows: 


1. The HP Defined Environment 
Field 


2! HP defined environment 


Hewlett-Packard supplies a number of 
environment files with IFS/3000. For ease of use, 
the most commonly used HP-defined environments 
are listed as alternate selections adjacent to this 
field. This enables you to use one of these 
environments as an initial environment by typing 
the appropriate letter in the data entry field. 


If you also select a reduction in the Reduction 
field, IFS/3000 rotates and scales the logical page 
in these environments so that the desired number 
of logical pages fit on the physical page. Any 
character fonts included in these environments are 
also rotated so that printing is in the same 
orientation as the logical page. Refer to the 
Reduction field discussion which follows in this 
section. 


The environment alternates available in this field 


are defined as follows: 
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Regular line printer 


This environment includes a logical page 
with a width that is greater than the height. 
This page format will be referred to as a 
Landscape orientation throughout IFS/3000 
procedures. 


This environment simulates a line printer 
environment except that the physical page is 
11 by 8 1/2 inches instead of the standard 
line printer page size of 14 3/8 by 11 inches. 
As with a standard line printer, the logical 
page has 66 print lines and 132 character 
positions on each line. An 8 point simulated 
line printer font is also included. 


You can duplicate a line printer application 
requiring a preprinted form by adding a 


which simulates a typewriter with Pica type 
(10 characters per inch). 


You can produce the effect of varying typing 
elements on a typewriter by adding other 
character fonts to this environment using the 
Character Font Menu. 


Typewriter, 12 pitch 


This environment has the same physical and 
logical page specifications as the above 
environment. 


This alternate prints 12 characters per inch, 
or 90 characters per line. It includes a 12 
pitch font which simulates an _ Elite 
typewriter font. A 12 pitch italics font is 
also included as the secondary font. 


form to the logical page on the Logical Page 
Menu. Document 


Typewriter, 10 pitch 


This environment includes a logical page 
with a height that is greater than the width. 
This page format will be referred to as a 
Portrait orientation throughout IFS/3000 
procedures. 


The pshysical page is 8 1/2 by 11 inches. 


This environment has the same physical and 


logical page specifications as the PF 
Portrait environment. 


The document. environment includes a 
proportionally spaced Roman character font 
in 12 point type as the primary font, 12 
point Bold as the secondary font, and 12 
point italics as an alternate font. 


There are six lines per inch, or 66 lines per 
physical page. There are 75 characters on LE Landscape 
each line, leaving a 1/2 inch margin on both 
the left and right sides of the logical page. 
The environment includes a 10 pitch font 


This environment includes a logical page 
with a width that is greater than the height. 
This page format will be referred to as a 
Landscape orientation throughout IFS/3000 
procedures. 
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The physical page is 8 1/2 by 11 inches. 
This environment contains no character 
fonts. You would use this alternate to 
initialize the specifications for a Landscape 
environment. You would add logical pages 
and character fonts using the Logical Page 
and Character Font Menus. 


P Portrait 
This environment includes a logical page 
with a height that is greater than the width. 
This page format will be referred to as a 
Portrait orientation throughout IFS/3000 
procedures. 


The physical page is 8 1/2 by 11 inches. 
This environment contains no character 
fonts. You would use this alternate to 
initialize the specifications for a Portrait 
environment. You would add logical pages 
and character fonts using the Logical Page 
and Character Font Menus. 


2. ine Reduction Field 


This field is device dependent an 
if you have also specified the 
in the Device field on the Main 









A Laser Printer 


This field is also an option which can ONLY be 
used with the environments listed as alternates in 
the HP Defined Environment field. 


When you choose a reduction, IFS/3000 uses an 
environment which includes a form in the logical 
page definition. This form consists of a single line 


THE INITIALIZE MENU 


used as a border around the logical page. You can 
remove this border by modifying the environment 
file. To do this, use the Logical Page Forms Menu 
to remove the names of the border form and form 
file. 


Refer to Figures 3-7 and 3-8 which illustrate the 
effect of specifying one of the following reduction 
options: 


2 2 to l 
Choosing a 2to 1 reduction enables you to 
print twice as much in the same amount of 
space by rotating and scaling two logical 
pages to a single physical page. See Figure 
3-7. 


4 4 to l 
Choosing a 4to 1 reduction enables you to 
print four times as much in the same amount 
of space by rotating and scaling four logical 
pages to a single physical page. See Figure 
3-8. 


3. The Another Environment Field 


Another environment 








This field allows you to supply the name of any 
existing environment file that you want to use as 
an initial environment. 


You enter the environment filename _ using 
standard MPE File System naming conventions 
where the filename may have up to 8 characters, 
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and can be any letter followed by any letter or 
number. If the file resides in a group other than 
the sign-on group, you must specify a groupname 
and accountname. You may also specify a 
lockword if this form of security applies to the 
file. 


If you used all of these file designation conventions 
the field data entry would appear as follows: 


Another environment 





When you press (ENTER), IFS/3000 checks to see 
that the filename specified exists, and that it is an 
environment file. If the file does not exist as 
specified, a status message will be issued to the 
banner window indicating that: 


e The filename does not meet MPE filename 
conventions as specified. 
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e The file does not reside in the group and 
account specified, where the group and account 
is different from the group where the program 
is being run. 


e You cannot access the file in the group and 
account specified due to security violations. 


e The file specified is not an environment file. 


OR, the environment specified will be copied and 
the Main Menu will be displayed. 


If you use this field, you may not enter a reduction 
selection. To achieve reduction with a custom 
environment, you must include the appropriate 
logical page and character font definitions using 
the Logical Page and Character Font Menus. 
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PAGE 0006/COBTEXT CALENDAR 
PAGE 9005/COBTEXT CALENDAR 


00184 019700 

00147 915900 00185 019800 DAYS-TABLE. 
00148 016000 01 FONT-NUMBERS. 00186 019900 SUNDAY PIC X(10) VALUE " SUNDAY". 
00149 016100 MONTH-YR- FONT PIC 89(4) COMP VALUE 0. 00187 020000 MONDAY PIC X(10) VALUE " MONDAY" . 
96150 016200 CAL-DAYS- FONT PIC $9(4) COMP VALUE 1. 00188 020100 TUESDAY PIC X{10) VALUE " TUESDAY". 
60151 016300 WEEK-DAY-FONT PIC S9(4) COMP VALUE 2. 00189 020200 WEDNESDAY PIC X(10) VALUE “ WEDNESDAY”. 
00152 016330 DOT-LINE-FONT PIC $9(4) COMP VALUE 2. 00190 620300 THURSDAY PIC (10) VALUE ” THURSDAY". 
60153 016400 JUL-DAYS- FONT PIC S9(4} COMP VALUE 3. 00191 020400 FRIDAY PIC X(10} VALUE “ FRIDAY”. 
69154 016500 DEFAULI-FONT PIC S9(4) COMP VALUE 4, 00192 020500 SATURDAY PIC X(10) VALUE “ SATURDAY". 
90155 016700 00193 020600 WEEK-DAYS REDEFINES DAYS-TABLE. 
90156 016800 DOTTIED-LINE. 00194 020700 05 DAYS-TABLE OCCURS 7 TIMES. 
00157 016900 05 FILLER PIC X(18) VALUE ALL ".“. 00195 020800 10 WEAK-DAY PIC X(10}. 
00158 017000 00196 020900 
00159 017100 MONTH-FIELD-DATA. 00197 021000 FIELD-DAYS. 
99160 017200 05 CALENDAR-LOGO. 00198 021100 SUNDAY PIC X(6} VALUE “DAYS1 “. 
99161 017300 10 CALENDARLOGO PIC X SPACES. 00199 021200 MONDAY PIC X(6) VALUE “DAYS2 “. 
90162 017400 10 CAL-CHARSET Pic s9(4) 00200 021300 TUESDAY PIC X(6) VALUE “DAYS3 ". 
00163 017500 05 CREATOR-NAME. 00201 021400 WEDNESDAY PIC X(6) VALUE “DAYS4 “. 
00164 017600 10 CREATORNAME PIC X(30) SPACES, 00202 021500 THURSDAY PIC X(6) VALUE "DAYS5 ". 
00165 017700 10 CREATOR-FONT PIC s9(4) . 00203 021600 FRIDAY PIC X(6) VALUE “DAYSS ". 
00166 017800 05 CAL-HEADING, 00204 021700 SATURDAY PIC X(6) VALUE "DAYS7 ° 
00167 017900 10 CALHEADING PIC X(52) SPACES. 00205 021800 FIELD-TABLE REDEFINES FIELD-DAYS. 
00168 018000 10 HEADER-FONT Plc $9(4) 00206 021900 05 FIELD-TAB OCCURS 7 TIMES. 
00169 018100 05 CAL-NOTE. 00207 022000 10 DAY-FLD-NAME PIC X(6}. 
00170 018200 10 CALNOTE PIC X(52) SPACES. 00208 022100 
00171 018300 10 CALNOTE-FONT PIC S9(4) . 00209 022200 FORMATED-DATE. 
00172 018400 05 SALES-NAME. 00210 022300 05 YY PIC Xx. 
00173 018500 10 SALESNAME PIC X(52) SPACES. 00211 022400 05 MM PIC Xx, 
00174 018600 10 SALE-NAME-FONT PIC $9(4) 00212 022500 05 DD PIC XX. 
00175 018700 05 SALES-ADDRESS. 00213 022600 
90176 018800 10 SALESADDRESS PIC X(52) SPACES. 00214 022700 CALENDAR-YEAR. 
00177 018900 10 SALES-ADDR-FONT PIc s9(4) 00215 022800 05 FIRST-TUO-NO PIC XX VALUE "19". 
90178 019000 05 SALES-CITY. 00216 022900 05 CALENDAR-YR PIC XX. 
80173 019100 10 SALESCITY PIC X(52) SPACES. 00217 023000 
G0180 019200 10 SALES-CITY-FONT PIC s9(4) . 00218 023100 FIRSTI-LAST-DAYS. 
90181 019300 SALES- INFO. 00219 023200 FIRST-CAL- DAY PIC X(6) VALUE SPACES. 
00182 019400 10 SALESINFO PIC X(52) SPACES. 00220 023300 LAST-CAL-DAY PIC X(6) VALUE SPACES. 
00183 019500 10 SALES-INFO-FONT PIC S9(4) 00221 023400 BEGIN-WK-DAY PIC 9 COMP VALUE 0. 

00222 023500 CUR-PRT-CAL-DAY PIC x(6). 

00223 023600 CUR-CAL-DATE REDEFINES CUR-PRT-CAL-DAY. 

00224 023700 YY-DSPL PIC 99, 

00225 023800 MM-DSPL PIC 99, 

00226 023900 DD-DSPL PIC 99, 

00227 024000 DD-DSPL-2 REDEFINES DD-DSPL. 

00228 024100 15 DD-FIRST PIC 3. 

00229 024200 15 DD-SECOND PIC 9, 

00230 024300 CAL-CNTR. 

00231 024400 10 YY-COMP PIC S9(4} COMP. 

00232 024500 10 MM-COMP PIC S9(4) COMP. 

00233 024600 10 DD-COMP PIC $9(4) COMP, 

00234 024700 








Figure 3-7. 2 to 1 Reduction With an HP-defined Environment 
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PAGE OOOS/COBIEXT CALENDAR PAGE 0006/COBTEXT CALENDAR 


00147 015900 00184 013700 
00148 016000 01 FONT- NUMBERS. 00185 019800 01 DAYS-TRBLE. 
00149 016100 OS MONTH-YR-FONT PIC $9(4) COMP VALUE 0. 00186 01990 0S SUNDAY PIC X(10) VALUE SUNDAY" 
01d 016200 05 CAL-DAYS-FONT PIC $9(4) COMP VRLUE 1. 00187 020000 05 monday PIC X(10) VALUE HONDAY" 
0018! 0160 O05 WEEK-DAY-FORT PIC $9(4) COMP VALUE 2. 00188 920100 0S TUESDAY PIC X(10) VALUE TUESDRY" 
00152 01630 05 QOT-LINE-FONT PIC $9(4) COMP YRLUE 2, 00189 020200 05 WEONESDAY PIC X(10) VALUE " WEDNESDAY" 
00153 016400 05 JUL-DAYS-FONT PIC $9(4) COMP VALUE 3. 001% 02000 05 THURSDRY PIC X(10) VALUE THURSDAY”. 
00154 016500 05 OEFAULT-FONT PIC $9(4) COMP VRLUE 4. 00191 020400 05 FRIDAY PIC X(10) VALUE " FRIDAY”. 
00155 016700 : 00132 020500 05 SATURDAY PIC x(410) VALUE " SATURDAY”. 
00156 016800 DOTTED-LINE. 00133 020600 WEEK-DAYS REOEFINES DAYS-TABLE. 
00157 016900 OS FILLER PIC X(18)} VALUE ALL ”.". 00194 020700 OS DAYS-TABLE OCCURS 7 TIMES. 
00158 017000, 00195 020800 10 WERK-DAY PIC x(10). 
00159 017100 MONTH-FIELO-DATA. 00196 920900 
160 017200 05 CALENDAR-LOGO. 00197 921000 FIELD-OAYS. 
00161 O17 300 40 CALENDARLOGO x VALUE SPACES. 198 021100 0S SUNDAY PIC X(6) VALUE “DAYS! ”. 
00162 017400 10 CAL-CHARSET 3$9(4) CONP. 0199 021200 0S = NGNDAY PIC X(6) VALUE "DAYS2 
00163 017500 05 CREATOR-NANE. 0200 021300 05 TUESDAY PIC X(6) VALUE “DAYS3 
00164 017600 40 CREATORNANE X(30) VALUE SPACES. 00201 021400 OS WEDNESDAY PIC X(6) VALUE "DAYS4 
00165 017700 40 CREATOR-FONT $9(4) COMP. 00202 021500 05 THURSDRY PIC X(6) VALUE "ORYS5 
00166 017800 05 CAL-HEADING. 0203 021600 OS FRIDAY PIC X(6) VALUE "ORYSE 
00167 017900 10 CALHEADING %(52) VALUE SPACES. 00204 021700 05 SATURDAY PIC X(6) VALUE “ORYS7 
00168 018000 10 HEADER-FONT $9(4) comp. 00205 021800 FIELD-TABLE REDEFINES FIELO-OAYS, 
169 018100 05 CAL-NOTE. 00206 021900 05 FIELO-TAB OCCURS 7 TINES. 
00170 018200 10 CALNOTE %(52) VALUE SPACES. 00207 022000 10 DAY-FLO-NANE PIC K(6). 
Or7t 018300 10 CALNDTE-FONT $9(4) Con. 00208 022100 
00172 018400 05 SALES-RANE. 00209 022200 FORMATED-DATE. 
00173 018500 10 SRLESWAME (52) VALUE SPACES. 210 02200 os YY PIC XX, 
00174 018600 10 SALE-NANE-FONT $9(4) cone. 21 022400 05 NK PIC XX. 
00175 018700 OS SALES-ADORESS. 0212 022500 os DD PIC xx, 
00176 018800 10 SALESRDDRESS %(52) VALUE SPACES. 00213 022600 
00177 018900 10 SRLES-ADDR-FONT $94) conP. 0214 022700 01 CALENDAR-YEAR. 
00178 019000 O05 SALES-CITY. 00215 022800 0S FIRST-TWO-NO PIC XX VALUE "19". 
00179 019100 10 SALESCITY %(52) VALUE SPACES. 00216 022900 OS CRLENDRR-¥R PIC XX, 
00180 019200 10 SALES-CITY-FONT $9(4) COMP. 0217 02000 
00181 013300 SALES-INFG. 218 023100 FIRST-LAST-ORYS, 
00182 019400 10 SALESINFO %(52) VALUE SPACES. 00219 023200 OS FIRST-CAL-DAY PEC K(6) VALUE SPACES. 
00183 019500 10 SALES-INFO-FONT $9(4) Comp. 0220 023x0 OS LAST-CAL-DAY PIC X(6) VALUE SPACES. 
00221 023400 05 BEGIN-WK-DAY PIC 9 COMP VALUE 0. 
00222 923500 OS CUR-PRT-CAL-DAY PIC X(6). 
0223 023600 05 CUR-CAL-DATE REDEFINES CUR-PRT~CAL-DAY. 
0224 923700 10 YY-DSPL PIC 93, 
0225 923800 10 MN-DSPL PIC 99. 
0226 92390 10 BD-OSPL PIC 99. 
227 024000 10 GD-DSPL-2 REDEFINES DD-DSPL. 
0228 924100 15 OD-FIRST PIC 9, 
229 024200 15 OD-SECOND PIC 9. 
O2H 02400 CAL-CNTR. 
0231 024400 10 ¥¥-COKP PIC $9(4) Con. 
00232 924500 10 NM-CONP PIC S9(4) COMP. 
0233 024600 10 DD-CONP PIC $a(4) COMP. 
02K 924700 
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00235 O24 HOD ER ARERR RAK IRI RIK RRR RI RITE RR IR EIR 00294 030600 PROCEDURE DIVISION. 

00236 925000** IFS INTRINSIC CALL PARAMETERS ** 292 03070) 

00237 0.25 100 89 RI RII POSE IOI RIOR IIR, 00293 030800 AOO-NRIN-LOGIC. 

00238 025200 00294 00H) 

0239 025300 01 CONRRER. 00295 031000 OPEN INPUT CALENDAR-PARNS. 

00240 025400 OS CONAREA-ALL PIC $9(4) COMP OCCURS 5000 TIMES. 00296 031100 HOVE ZERO TO SPEC-POINTER. 

241 025500 01 ARERLENGTH PIC $9(4} COMP VALUE S000. 00297 031200 

00242 025600 00293 031300 A10-READ~BEG~END-PARNS, 

243 025700 01 ERRMSG. 00239 031400 

00244 025800 OS ERROR-OUT PIC X(82). 00300 011500 READ CALENDRR-PARMS AT END 

00245 025900 01 ERRNSG-LEN PIC $9(4) COMP VALUE 82. 00301 031600 CLOSE CALENDAR-PRRMS 

00246 026000 00302 031700 GO TO A2O-CHECK-CALENDRR-PARRS. 
00247 026100 01 FRMOESIG PIC xX(10). 00303 031800 DISPLAY “INPUT-PARNS ARE “ INPUT-PARNS, 

00248 026200 01 FOPTIONS PIC S$(4) COMP VALUE ZERO. 00304 031900 

249 0260 01 AOPTIONS Pic $9(4) COMP VALUE ZERO. 00305 932000 IF NOT (BEG-END OF INPUT-PARNS = "BEG" OR "END" GR "TOP"} 
0250 026400 01 FILENUN PIC S9{4) COMP VALUE ZERO. 00306 032100 DISPLAY "RECORD MUST BEGIN WITH 'SEG', *END’ OR *TOP’" 
00251 026500 01 DISPOSITION PIC $9(4) COMP VALUE ZERO. 00307 032200 GO TO R10-READ-BEG-ENO-PRRHS. 

0252 926600 01 SECCODE PIC S9{4) COMP VALUE ZERO. 00308 032300 

00253 926700 00309 032400 IF BEG-END = "TOP" 

00254 026800 01 ENVFILENANI. 310 032500 GO TQ A1S5-CALENDAR-HEADINGS. 

255 926900 OS  ENVFILENANE PIC K(29) VRLUE SPACES. OO31t 932600 ~ 

00256 027000 O05 E0S1 PIC X VRLUE HIGK-VALUES. W312 032700 MOVE YYNMDD-DATE OF INPUT-PARMS TO FORMATED-DATE. 
00257 927100 00313 932800 PERFORM UOO-DATE-VALIDATE THRU U30-EXIT. 

00258 027200 IDSFORMNANS, 00314 032900 If FORMATED-DATE = “ERROR' 

00259 027390 O5 IDSFORN-NANE PIC X(15) VALUE "CALENDAR" 00315 933000 GO TG Ai0-READ-BEG-ERD-PARNS, 

00260 027400 05 E6s2 PIC X VALUE HIGH-VALUES. 00316 033100 

00261 027500 00317 933200 IF BEG-END OF INPUT-PARMS = "BEG" 

00262 027600 LPAGE-NO PIC $9(4) COMP VALUE ZERO. OO318 03330 IF FIRST-CAL-DAY = SPACES 

263 927700 00319 032400 MOVE YYNMDD-OATE QF INPUT-PARMS 10 FIRST-CRL-OAY 
00264 927800 FLONANE1. 0320 033500 MOVE WEEK-DAY OF INPUT-PRARNS TO BEGIN-WK-DAY 
0026S 027900 OS FLDNANE PIC x(15) VALUE SPRCES. 00325 032600 ELSE 

00266 928000 05 E0S3 PIC x VRLUE HIGH-VALUES. 00322 033700 DISPLAY "ORLY ONE BEGIN DATE CAN BE SPECIFIED 
00267 028100 00323 033800 GO TO R10-READ-BEG-END-PARMS. 

268 928200 SUBF LOKUS PIC $9(4) COMP VALUE ¢. 324 933900 

0269 0280 00325 034000 IF BEG-ENO OF INPUT-PARMS = "END" 

00270 028400 ORTRX, 00326 934100 TF LAST-CAL-DAY = SPACES 

90271 028500 05 DATAI PIC X(80) VALUE SPACES. 00327 034200 HOVE YYHMDO-OATE OF INPUT~PARNS 10 LAST-CAL-~DAY 
00272 028600 OS £084 PIC X VALUE HIGH-VRLUES. 00328 034H0 ELSE 

00273 0287200 00329 034400 OISPLAY "ONLY ONE END DATE CAN BE SPECIFIED" 
00274 02880) NEWPRINNUN PIC $9(4) COMP VALUE ZERO. 03H 9034500 GO TO A10-READ-BEG-END-PARNS. 

00275 0289), NEWSECHUR PIC $9(4) COMP VALUE +. 0031 03460 

00276 029000 0332 034700 GO TO A10-RERD-BEG-END-PARMS. 

00277 929100 CALL-ERR-OISPLAY. 00333 934800 

00278 929200 O5 FILLER PIC X(14) VALUE "RETURNED FROM". 00334 034900 A15-CALENDAR-HERDENGS. 

00279 629300 O05 CALL-E-D PIC X(20) VALUE SPACES. 00335 935000 

00280 929400 336 035100 MOVE INPUT-PARNS 10 FIELD-HEADINGS. 

00281 029500 FLD-DATA-ERR. 00337 935200 MOVE CHARSET-NUNBER OF FIELD-HEADINGS TO NUMBER-TEST, 
00282 029600 OS FILLER PIC X(9)  VRLUE "TO FIELD“, 0338 03500 TF NOT (NUMBER-TEST > -1 AND HUNBER-TEST < 32) 

00283 029700 O05 FIELD-OUT PIC X(16), 00339 035400 DISPLAY “CHARACTER SET FOR FIELD DATA INVALID" 
00284 029800 O5 FILLER PIC X(10) VALUE" DATA IS ". 00340 035500 " CHARSET-NUMBER 

00285 029900 O05) DATA-OUT PIC x(30). 00341 035600 7 “THE DEFAULT CHARSET # 4° 

Od286 Q30000 . 00 34e 035700 MOVE 4 TO NUMBER-TEST. 

0008 ON 100 OL DATALEN S94) CAMP VALE 82. 00343 

MTSE ORANG 003446 TF SPECTAL-FLOS = °S" 

OIF OX O1 LANGPARE S9¢4) COMP VALE ? 00346 CO 1G AI8-SPECIAL-HERDINGS. 

OOD 2E ENae OO ME 





Figure 3-8. 4 to 1 Reduction With an HP-defined Environment 
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The Physical Page Menu 


1 Number of copies 
N Multi-copy forms? Y/N 


Width 


Length (in direction of paper motion) 
— Units for page dimensions (I - inches, C - centimeters) 


Initial primary character font number 


-OR- / name 


Initial 





ter font number 
-OR- / name 


Figure 3-9. The Physical Page Menu 





If you enter PF. in the Main Menu Selection field, 
the Physical Page Menu is displayed. 


The specifications on this menu will default to the 
standard 8 1/2 by il page size for the device 
specified in the Device field on the Main Menu: IP, 
you do not use the option of initiating a new 
environment using the Initialize Menu; OR, you do 
not copy these specifications using the Copy Menu; 
OR, you do not respecify the defaults. 


These specifications establish the physical page size 
and all other environment defaults. 


This menu also provides the menu path to the 
Multi-Copy Forms Menu where you specify forms 
to be associated with the physical page. 


You would use the Logical Page Menu to define 
alternate page layouts to be printed within the 
limitations of the physical page. 
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Function Keys 


The function keys used with this menu are: 
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Once you have typed your 
physical page specifications in the 
menu fields, press the key 
to issue this data to the computer. 
IFS/3000 will issue — status 
messages to the menu banner if 
inconsistencies are found between 
the physical limitations of the 
device specified on the Main 
Menu and the physical page 
specifications you have requested. 
OR, the program will issue a bell 
to indicate the field data 1s 
acceptable. The menu will 
remain on the screen for your 
review; OR, the Multi-Copy 
Forms Menu will be displayed, if 
specified. If you do not make any 
changes, you can press 
again, or press the | 
function key to return to the 
Main Menu. 


Press Cf#6_) to redisplay the 
terminal screen with any data 


entered using the key. It 
is useful when you have used the 





Press to return to the 
Main Menu. Note that any field 
data you have typed but have not 
entered will be lost. 








Press to delete any data 
you have just typed, but have 
decided not to enter. 


Field Discussion 


There are six groups of data entry fields on the 
Physical Page Menu. 


You use these fields to define the dimensions of the 
physical page, the primary and secondary character 
font defaults, and whether or not you want the 
Laser Printer to print multiple copies of the 
physical page as a single print job. 


In addition, you can also specify that you wish to 
go to the Multi-Copy Forms Menu where you can 
specify up to eight pairs of forms to be associated 
with the physical page. You would use this menu 
path if your environment was to be used to 
simulate carbon copy production. 


The field data and its effect on the environment is 
defined as follows: 


1. The Number of Copies Field 





Number of copies 


The default value for this field is 
may request up to 32,767 copies of the physical 


page by entering the number of copies desired in 
this field. 





Copies of a physical page are generated by the 
Laser Printer by issuing the specified number of 
physical page ejects for each new page instruction 
associated with the data file. In a multi-page 
print job, each page will print the number of times 
specified in this field, and you would have to 
collate the copies manually. 


If you want collated copies of a multi-page print 
job, you must specify the number of copies within 
the print file equation (see Appendix A). Copies of 
multi-page documents generated in this manner 
are reissued by the host computer once for each 
copy requested. The environment file is reloaded 
in the Laser Printer on each issue from the host 
computer. 


2. The PMulti-Copy Forms? Field 





which are to be used to simulate carbon copy 
output. Refer to the Multi-Copy Forms Menu 
discussion which follows in this section. 


3. The Physical Page Size Fields 


Width 
Length 
Units 





There are three data entry fields in this group. 
You use these fields to define the dimensions of the 
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physical page. The first field defines the page 
width. The second defines the page length. The 
third field defines the units of measure to be used 
to calculate the width and length. 


These fields default to the standard 8 1/2 by 11 
paper size dimensions for the device specified in 
the Device field on the Main Menu. You can 
change these defaults by changing the dimensions 
to the alternate paper size for your printer model. 


The physical page refers to the actual paper 
surface that passes through the printer and is 
exposed to the printers electrophotographic 
transfer drum. Its dimensions are determined by 
the Laser Printer model installed on your system. 
Refer to the Operator’s Handbook for your printer 
model to determine the paper and, therefore, the 
physical page sizes available. 


The physical page size establishes the maximum 
dimensions available for printing all other 
components of your environment. Each printer 
model also has unique border areas along the edges 
of the physical page which are outside of the 
transfer area of the printer transfer drum. Any 
logical page specifications you define on the 
Logical Page Menu which extend beyond the 
physical page size, or fall within the unprintable 
border areas will result in error or warning 
messages specific to the limitations exceeded. 


IFS/3000 uses the physical page dimensions you 
specify in these fields when compiling your 
environment. This does not ensure that the paper 
in the output device has these dimensions. If your 
system changes paper sizes frequently, you can tell 
the operator the size of paper to load into the 
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printer using the MPE :FILE command or the 
FOPEN intrinsic. Refer to Appendix A. 


You define the physical page dimensions using 
these fields as follows: 
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Width 


You define the page width in this 
field as a whole number with a 
decimal fraction. It will be 
calculated in the units specified in 
the associated Units field. 


The width of the page is measured 
perpendicular to the direction of the 
paper movement through the Laser 
Printer, and is device dependent. The 
printer model was a _ required 
specification in the Device field on 
the Main Menu. 


Where the device has been specified 





11 tractor-fed paper is being used; 
the default entry would be: 





11 saele sheet paper is being used; 
the default entry would be: 


Width 





Length 
(in direction of paper motion) 


You define the page length in this 
field as a whole number with a 
decimal fraction. It will be 
calculated in the units specified in 
the associated Units field. 


The length of the page is measured 
parallel to the direction of the paper 
movement through the Laser Printer, 
and is device dependent. The printer 
model was a required specification in 
the Device field on the Main Menu. 


Where the device has been specified 
A, and the standard 8 1/2 by 
11 tractor-fed paper is being used; 
the default entry would be: 





Length 





Where the device has been specified 
and the standard 8 1/2 by 
11 single sheet paper is being used: 
the default entry would be: 








Length 


Units 


The default for this field is FE 


(=Inches). You may respecify this 
field by changing the £ to c 
(=Centimeters). 


The unit value in this field is used to 
calculate the physical page 


dimensions specified in the associated 
width and length fields. 


4. The Primary and Secondary 
Font Fields 





Initial 
-OR- = 


ary font number 
name 












Initial secondary font number 
~OR- name 





These fields are useful for controlling which fonts 
will be used as primary and secondary character 
fonts. If you do not specify a primary and 
secondary character font using these fields, 
IFS/3000 defaults to the character font which has 





ID Q1) as the secondary character font. 
If only one character font is defined in the 
environment, it is used for both the primary and 
secondary fonts. If no character fonts have been 
defined in the environment, IFS/3000 uses 
character font number 31, the Laser Printer 
default, for both the primary and secondary fonts. 


You define the primary and secondary character 
fonts using these fields as follows: 


You choose the primary character font by typing 
the character font [O-number, OR, character 
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any character font which has been defined in the 
environment. NOTE: You may not use the 


20-number and the name. 


You choose the secondary character font by 


typing the desired character font’s tH-number 





any character font which has been defined in the 
environment. NOTE: You may not use the 


use the Character Font Menu (described later in 
this section). 


You may associate instructions with the data file 
which will activate the secondary character font. 
Refer to the discussion, "Primary and Secondary 
Character Fonts" in Section 2. 
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5. The Default Measurement 
System Field 


units you select here will establish the default 
system of measurement for all specifications 
entered on the Logical Page, Logical Page Forms, 
Vertical Format Control, and Character Font 
Menus. 


6. The Default Form File Field 


Default Form File 





This is an optional field. IF you specify a forms 
filename in this field, IT becomes the default forms 
file for the environment. 


All forms for an environment are usually 
contained in a single forms file. You can save time 
when specifying each form on the Logical Page 
Forms and Multi-Copy Forms menus _ by 
establishing the forms filename as the default in 
this field. This enables you to enter the form 
name on these menus without having to repeat the 
filename for each entry by defaulting to the 
filename you have established here. 
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You enter the name of the forms file using 
standard MPE File System naming conventions, 
where the filename may have up to 8 characters, 
and can be any letter followed by any letter or 
number. If the file resides in a group other than 
the sign-on group, you must also specify a 
groupname and accountname. You may also 
specify a lockword if this form of security applies 
to the file. 


If you need to use all of these file designation 
conventions, the field data entry would appear as 


follows: 


Default Form File 


When you press (ENTER), the IFS/3000 program 
checks to see that the filename specified exists and 
that it is a forms file. If the file does not exist as 
specified, a status message will be issued indicating 
that: 


e The filename does not meet MPE filename 
conventions. 


e The file does not reside in the group and 
account specified. 


e You cannot access the file due to security 
violations. 


e The file specified is not a forms file. 
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Form File (if not default) 





Logical page that will be used to write to these forms 


Scale? Y/N 


Figure 3-10. The Multi-Copy Forms Menu 


the Physical Page Menu and press (ENTER), the 
Multi-Copy Forms Menu is displayed. 


You use this menu to specify up to eight pairs of 
forms to be printed on the physical page. If you 
want to write data to the forms at print time, you 
must also identify the logical page which has been 
designed to position data within the forms. You 
would use the Logical Page Menu to design the 


associated logical page before you identify it on 
this menu. 


This procedure can be used to simulate carbon copy 
production where different configurations of the 
same general form appear on subsequent physical 


pages. 
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Function Keys 


The function keys used with this menu are: 
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Once you have typed the required 
field data and any optional data 
in the menu fields, press the 
key to issue the data to 
the computer. IFS/3000 will 
issue status messages to the menu 
banner JF it has difficulty 
accessing the specified form, form 
file, or logical page; OR, if the 
form(s) specified will not fit 
within the limitations of the 
physical page. OR, the program 
will issue a bell to indicate that 
the field data is acceptable. The 
menu will remain on the screen 
for your review. IF you do not 
make any changes, you can press 
again, OR press the 
7 Main function key, to return 
ain Menu. 






Press (A6_) to redisplay the 
terminal screen with any data 


entered using the key. It 


ful when you have used the 








Press to return to the 
Main Menu. Note that any field 
data you have typed but have not 
entered will be lost. 


Press to delete any data 
you have just typed, but have 
decided not to enter. 


Field Discussion 


There are four groups of data entry fields on the 
Multi-Copy Forms Menu. 


You use these fields to identify the forms you wish 
to use, the filename in which they reside, the 
logical page to be used to write data to the forms, 
and if the program is to scale the forms to fit 
within the logical page limitations. 


When you associate a logical page, IFS/3000 
centers the forms ON the logical page. If you also 
scale the forms, IFS/3000 centers the forms 
WITHIN the printable area of the logical page. 
You should determine if your form includes 
borders which are to extend beyond the printable 
area of the logical page, or if the entire form is to 
be positioned within the printable area. You 
cannot write data to any part of a form which 
extends beyond the printable area defined in a 
logical page layout. 


You MUST associate a logical page with your 
forms IF you want to scale and position the forms 
on the physical page, AND you want the forms to 
have the same orientation as the logical page used 
to write data at print time. 


You can use a pair of forms to define each copy of 
a multiple part form. Normally you use the first 
form in the pair to define the parts of the form 
which are constant from one copy to the next. 
You use the second form in the pair to define the 
parts of the form which vary from one copy to the 
next. IFS/3000 overlays the first form in each 
pair with the second form in the pair, centering 


each form on the associated logical page. Each 
form must be designed so that it is placed 
appropriately when the forms are overlayed. This 
is easier if both parts of the form are the same size 
and shape. 


The field data and its effect on the environment is 
defined as follows: 


i. The Logical Page Field 





Logical Page that will be 
used to write to these forms 


This is an optional field. You would use this field 
to identify the logical page to be used to write data 
to the form specified in the associated Form field. 


The logical page you identify here should define 
the position where data will print within the form 
layout. In addition, the forms will be rotated so 
that the forms and the print have the same 
orientation as the logical page. You may also 
specify that the forms be scaled to fit within the 
logical page using the Scale? Field on this menu. 


page that has been ‘defined in the environment. If 
you do not specify a logical page, IFS/3000 uses 
the logical page with the lowest logical page 





defined in the. environment, IFS/3000 uses the 
Laser Printer default logical page. 


If the logical page you specify in this field has not 
been defined, the program issues a status message 
to the menu banner. 
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2. The Form Field 


Form 





This is a required field. You use this field to 
identify the forms you wish to associate with the 
physical page. The form’s name is the name 
assigned when it was created in IDSFORM. The 
field provides enough space to enter up to eight 
pairs of form names. You may repeat any form 
name as many times as desired. The form name 
can contain up to 16 characters, beginning with a 
letter, followed by any letter or number. 


If the form does not exist in the form file specified, 
IFS/3000 displays an error message in the menu 
banner. 


The forms print in the order that they are 
specified in this field. 


You can specify up to two forms to be used to 
produce the first copy. In this case, the Laser 
Printer prints the first form and then overprints it 
with the second to give the appearance of a single 
form. If you are also writing data to the form at 
print time, the data is printed to the position 
defined by the associated logical page. The Laser 
Printer then issues a physical page eject. 


The second copy is printed on the next page in the 
same pattern: the first form specified for copy two 
prints, the second form specified overprints, and 
the same data then overprints the two forms. 
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The third, and each subsequent copy follows this 
procedure. . 


The field entry for the example shown in figure 
3-11 would be as follows: 


Form 





3. The Form File Field 


t default) 








This field is optional if you elected to specify a 
default forms file on the Physical Page Menu, and 
it contains the forms you wish to identify in the 
Form Name Field on this menu. You can override 
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the default forms filename by specifying a 
filename for any form which does not reside in the 
default forms file. IF you do not use the default 
forms file you MUST specify each forms filename 
individually. 


Normally all forms created using IDSFORM for a 
specific environment are stored in the same forms 
file. 


You enter the name of the forms file using 
standard MPE File System naming conventions, 
where the filename may have up to 8 characters, 
and can be any letter followed by any letter or 
number. If the file resides in a group other than 
the sign-on group, you must also specify a 
groupname and accountname. You may also 
specify a lockword if this form of security applies 
to the file. 


If you need to use all of these file designation 
conventions, the field data entry would appear as 


follows: 


Form File (if not default) 





When you press (ENTER), the IFS/3000 program 
checks to see that the filename specified exists, 
that it is a forms file, and that the form name 
resides within the file. The form definition is then 
included in the environment file and will be 
compiled when you perform that operation using 
the Main Menu. 
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F n al copy with EMPLOYEE INFORMATION FORM 
FOR MA, FORMC, and | LAST NAME. FIRST MIDDLE 


= 
04987 CHASE SAM vou | <-— data merged 
3 g SOCIAL SECURITY NO 


EMPLOYEE INFORMATION FORM 











ISTREET ADDR 1234 EAST APPLE ROAD SOCIAL SECURITY NO. 
city & STATE BOISE, IDAHO ze 83707 860 5h 9876 
HOME PHONE NUMBER WORK EXTENSION MUMGER DATE OF BIRTH (M/0/¥) 


922-0328 2680 12/31/53 FORMA entered on — 
Copy 1, Copy 2 
and Copy 3 


ze 








HOME PHONE NUMBER, | WORK EXTENSION NUMBER DATE OF BIRTH (M/D/Y) 





PRINTED FORMA 


OUTPUT 


FORMB entered on Copy 1. 
FORMC entered on Copy 2. 
FORMD entered on Copy 3. 


LOCATION NUMBER: DISTRIBUTION DATE OF HORE (M/D/Y) LOCATION NUMBER DISTRIBUTION DATE OF HIRE (M/D/Y) 
43h0 1/04/73 
PERSONNEL 








FORMD 














| PERSONNEL SUPERVESOR EMPLOYEE 


Figure 3-11. Multi-Copy Forms 
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If the file does not exist as specified, a status 
message will be issued indicating that: 


eo The filename does not meet MPE filename 
conventions. 


e The file does not reside in the group and 
account specified. 


e You cannot access the file due to security 
violations. 


e The form name does not exist within the file. 
e The file specified is not a forms file. 
If you did not elect to use the default forms 


filename on the Physical Page Menu, your entries 
in this field could have the following variations. 


Form File (if not default) 
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4. The Scale? Field 


Scale? Y/N 


scale your forms, you MUST also specify a logical 
page in the Logical Page Field on this menu, AND 


forms will then be rotated and scaled to fit within 
the logical page identified on this menu and all 
portions of the forms will be within the printable 
area defined on the logical page. 


When scaling forms, you must be aware of the 
process IFS/3000 uses. 


All lines and boxes are scaled to fit within the 
parameters of the logical page defined. When the 
form dimensions reach the limitations of the 
logical page either in width or height, the scaling 
process stops. Therefore, your form may be either 
narrow or short depending on the logical page 
parameters. 


When IFS/3000 scales the fonts it simply looks at 
the character font referenced in IDSFORM and 
selects from the sizes resident in that font. If the 
smallest available character font is too big, the 
type will extend beyond the lines on the form. 


The Logical Page Menu 


Logical page number 


Orientation: L - Landscape, RL - Reverse Landscape, 


P - Portrait, 


4 Change Forms or VFC? Y/N 


Width 
Height 


Distance from left 
Distance from top 


Overriding line spacing 
Left margin 


Font number for VFC -OR- 


Actual spacing information: 
dots character width 





RP - Reverse Portrait 


Units I-in, C-cm, M-mm, D-dots 
-~OR- 
number of characters 
number of lines 


-OR- 
lines/inch, LC - lines/em 
number of characters 


dots line height 


Figure 3-12. The Logical Page Menu 


the Logical Page Menu is displayed. 


This menu allows you to define the logical pages to 
be included in your environment file. For each 
logical page, you define its orientation, size, and 
location on the physical page. 


The Logical Page Menu contains the path to the 
Logical Page Forms Menu; the Logical Page Forms 
Menu contains the path to the VFC Selection 
Menu. 


When you go to the Logical Page Menu from the 
Main Menu, IFS/3000 displays the first logical 
page number. This is usually page number zero, 
unless you have entered a specific logical page 
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number on the Main Menu. The function keys 
allow you to access other logical page definitions. 


Function Keys 


The function keys used with this menu are: 
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Once you have typed your logical 
page specifications in the menu 
fields, press the key to 
issue this data to the computer. 
IFS/3000 will issue status 
messages to the menu banner if 
any required data is not specified, 
or if it has difficulty processing 
the data. OR, the program will 
issue a bell to indicate that the 
field data was acceptable. The 
menu will remain on the screen 
for your review, OR the Logical 
Page Forms menu will’ be 
displayed, if specified. You can 
use the function keys to proceed 
directly to another logical page, 
OR press the Main function key, 
to return to the Main Menu. 
Pressing again without 
making a change will also return 
you to the Main Menu. 


Press (_41__) to display the first 
logical page defined. If you have 
not defined specifications for this 
logical page, the menu will 
appear blank except for the 


defaults. 














Press (#2) to display the last 
logical page defined. If you have 
not defined specifications for this 
logical page, the menu will appear 
blank except for the logical page 


than the current logical page. If 
you have not defined 
specifications for this logical page, 
the menu will appear blank 
except for the logical page 


Press (A 4_) to display the 
Logical Page Menu for the 


ONE GREATER than _ the 
current logical page. IF you have 
not defined specifications for this 
logical page, the menu will 
appear blank except for the 


logical page EO-number. The 


Logical Page Menu provides the 
path to the Logical Page Forms 


Change Forms or VFC? Field and 
press (ENTER). 


Press Cf 6_) to redisplay the 
terminal screen with any data 


entered using the key. 


Press to return to the Main 
Menu. Note that any field data 
you have typed but have not 
entered will be lost. 








Press to delete any data 
you have just typed, but have 
decided not to enter. 


Fieicd Discussion 


There are six groups of fields on the Logical Page 
Menu. 


associated with the specifications unless you 
change it. It enables you to identify an individual 
logical page in a data file or application program 
which can then be activated or deactivated by the 
Laser Printer at print time. 


The second field allows you to specify whether or 
not the iogical page is active at the beginning of 
the print job. 


The third fieid establishes the orientation of the 
logical page as either landscape, portrait, reverse 
landscape or reverse portrait with respect to the 
physical page. Each orientation specifies a 
rotation of the logical page on the physical 
page. For more information refer to the 
description of logical page in Section 2. 


The fourth field is used to proceed to the Logical 
Page Forms Menu and subsequently to the Vertical 
Format Control Menu. 
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The remaining fields allow you to specify the 
dimensions of the logical page, to position the 
logical page exactly on the physical page, to 
describe some information relating to VFC 
specification and to set the left margins for 
printing characters on the logical page. 


At the bottom of this menu, protected fields are 
used to display the width and height of the 
character font chosen in the fields directly above. 
If no font is chosen here, a default is chosen as 
described below. 


The field data and its effect on the environment is 
defined as follows: 


1. The Logical Page Number Field 





Logical page number 


This is a required field. You can identify up to 32 
logical pages to be included in your environment. 
Each logical page must be defined individually and 


always appear in this field when the Logical Page 
Menu is displayed. The number that appears 
depends on the method you use to display the 
menu as follows: 


e If you did not enter a specific page number in 
the Font/Page number field on the Main Menu, 
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e If you DID enter a specific page number in the 
Font/Page Number, the logical page specified 
will be displayed. If you have not defined 
specifications for this font number, the menu 


and field defaults. 


e If you pressed a function key on this menu, the 


action described on the key label wiil be 
displayed. Refer to the function key 
discussions. 


You would change a logical page number ONLY if 
you wish to assign a different number than the 
number currently assigned on the menu. To change 


number in this field before using the key. 
This makes an identical copy of the logical page. 
Therefore, you may wish to delete the logical page 
you copied. 


2. The Initially Active? Field 





¥ Initially active? Y/N 


This is a required field. The default for this field is 


means you do not want the page to be initially 
active. 


A logical page must be active in order to print to 
it. Logical pages can be activated and deactivated 
during a print job either programmatically using 
the PACTIVATEPAGE and PDEACTIVATEPAGE 
intrinsics or using the .ACTIVATEPAGE and 
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.DEACTIVATEPAGE commands in the LPS 
interpreter. 


3. The Orientation Field 


Orientation: 





This is a required field for which there is no 
default. You use this field to specify the 
orientation of the logical page in relation to the 
physical page. Orientation can be specified as 
follows: 





Landscape 





Portrait 





Reverse Landscape 


Refer to Section 2, figure 2-6 for examples of the 
orientations available. 


4. The Change Forms or VFC? Field 


(no). You can specify forms to be associated with 
the logical page and/or change the vertical format 





Logical Page Forms Menu. This menu is used to 
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add, change or review forms associated with the 
logical page. The logical Page Forms Menu also 
contains a path to the Vertical Format Control 
(VFC) menu. 


returned to the Main Menu after you press 


(CENTER). 
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5. The Size Specification 
and Positioning Fields 


Width 
Height 


Distance from left 
Distance from top 


Overriding line spacing 
Left margin 





Font number for VFC -OR- 


The fourteen fields in this group allow you to 
specify the exact size of the logical page and its 
position on the menu. The first two fields, 
specifying width and height for the logical page, 
are required. The other fields are optional. 


You can use inches, centimeters, millimeters, dots, 
or characters and lines to measure the logical page 
dimensions and specify its position on the page. If 
you specify the logical page width using number of 
characters, IFS/3000 uses the Font number for 
VFC width to calculate the logical page width. 
Likewise, if you specify the logical page height 
using the number of lines, IFS/3000 uses the Font 
number for VFC height to calculate the logical 
page height. 


Physical characteristics of the HP Laser Printer 
force an unprintable margin area on the paper. 
This requires that you leave space on some edges of 
the physical page. You can define logical pages 
which extend into the unprintable area, but you 
cannot print clearly in the unprintable area. You 
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UNITS= I, C, M, D 
-OR- 

number of characters 

number of lines 


-OR- 
lines/inch, LC - lines/em 
number of characters 


| name 
cannot define a logical page which is bigger than 
the physical page defined in the physical page 


menu. 


The alternates for size specification and positioning 
fields are described below. 


Width 





The width actually consists of two required 
specifications, the unit of measurement specified in 
the Units field and the number of units specified 
in the Width field. If the space required io print a 
line exceeds the width specified, IFS/3000 may 
truncate characters during printing. Valid unit 
specifications for logical page width are inches, 
centimeters, millimeters, dots and number of 
characters, defined as follows: 


When using width in inches, centimeters and 
millimeters, the width must be smaller than 


the corresponding dimension specified for the 
physical page. 


When using number of dots to specify width, 
you should remember that different models 
of HP Laser Printers may have varying dot 
density. By using number of dots to specify 
dimensions, you are restricting use of the 
environment to a single device. 





NC number of characters, a 





When specifying NE 

number or name is used to compute logical 
page width. It is convenient to use the same 
character font you are using to print your 
document, but this is not required. For more 
information, refer to the discussion of the 
font number for VFC below. 





Height 


Height, like Width, is specified using two required 
fields. The unit of measurement is specified in the 
Units field and the number of units is specified in 
the Height field. The HP Laser Printer uses the 
height of the font font for VFC plus any inter-line 
spacing specified using IDSCHAR to calculate 
vertical spacing. You may change the method 
IFS/3000 uses to calculate vertical spacing by 
using the Vertical Format Control Menu. Valid 
units for measurement of height are inches, 
centimeters, millimeters, dots and number of lines 
specified as follows: 
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When specifying height in inches, centimeters 
or millimeters, the height must be smaller 
than the corresponding dimension specified 
for the physical page. 


When using number of dots to specify height, 
you should remember that different models 
of HP Laser Printers may have varying dot 
density. By using number of dots to specify 
dimension, you are effectively restricting use 
of the environment to a single device. 





When specifying number of lines, the VFC 
font number or name or the overriding line 
spacing, 1s used to compute logical page 
height. 


It is convenient to use the same character 
font you are using to print your document, 
but this is not required. For more 
information, refer to the discussion of the 
VFC font number and name below. 


Distance From Left 
Distance From Top 





The location of the logical page on the physical 
page is specified using the optional Distance From 
Left and Distance From Right fields along with 
their associated Units fields. When specifying the 
location of the logical page on the physical page, 
you view the physical page in the same orientation 
as the logical page. This means that you measure 
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from different places on the physical page for 
different logical page orientations. Figure 3-13 
shows examples of specifying the location of logical 
pages with varying orientations. To specify 
location, enter the unit of measurement in the 
corresponding Units fields and the number of units 
in the Distance From Left and Distance From Top 
fields. Units can be specified in inches, centimeters, 
millimeters or dots. If these fields are left blank, 
the logical page will be centered on the physical 


page. 





_ Overriding Line Spacing 


IFS/3000 uses the Overriding Line Spacing field to 
control line spacing for the logical page. This 
aliows you to vary the line spacing within the 
logical page, overriding the interline spacing 
defined using the font for VFC as a unit of 
measurement. 


If you do not enter a value in the Overriding Line 
Spacing field, IFS/3000 uses the cell height of the 
foni for VFC. If you do not specify a font for VFC 
below, IFS/3000 uses the initial primary character 
font as specified on the Physical Page Menu or the 
lowest number character font defined. 
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If you enter a value in the Overriding Line Spacing 
field, IFS/3000 uses this value instead of the cell 
height of the font for VFC. After you enter your 
specifications, IFS/3000 displays the actual line 
spacing to be used in the Line Height field in the 
Actual Spacing information at the bottom of the 
menu. This includes the inter-line spacing supplied 
in IDSCHAR. Refer to the IDSCHAR Reference 
Guide (part number 36581-90001). 


You enter a value in the Overriding Line Spacing 
field usually based on the cell height of the 
character font you are using to print your 
document. If you use a character font with a cell 
height that differs from that indicated by the 
Overriding Line Spacing field, the result may not 
be what you intended. 


You may change the method of controlling line 
spacing by selecting "No VFC" on the Vertical 
Forms Control menu. With "No VFC", the cell 
height of the character being printed controls the 
line spacing, and the Overriding Line Spacing field 
is ignored. 


Since the default for the HP/3000 is post-space 
mode, "No VFC" causes a line feed after printing a 
line equal to the height of the last character on the 
line (refer to Type of VFC Field in Vertical 
Format Control Menu). 


TOP 


LEFT 


REVERSE PORTRAIT 
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You enter the unit of measurement in the Units 
field and the number of units in the Overriding 
Line Spacing field. You can use _ inches, 
centimeters, millimeters, or dots to meausre line 
spacing, or you can express line spacing in lines per 
inch LI or lines percentimeter | 











The Left Margin field determines the distance 
printing will start from the left edge of the logical 
page. The valid units of measurement for the left 
margin are inches, centimeters, millimeters, dots, or 
number of charactérs. 


The left margin defaults to zero, causing the first 
print line to start at the left edge of the logical 
page. In most cases, you can use the default since 
the size and location of the logical page defines the 
apparent margin with respect to the physical page. 


Font number for VFC -OR- name 





You select the font for VFC from the fonts defined 
in your environment, but you do not have to use it 
to print your document. IFS/3000 refers to the 
font for VFC to calculate the vertical line spacing. 
You enter the number or name of the font in the 
Font for VFC fields. If you want to use the 
character font resident in the HP Laser Printer as 
the font for VFC, refer to the paragraphs on 
Effect of Character Font Number 31 below. 


If you use number of characters (NC) as the unit of 
measurement for Width, you must also specify the 
font for VFC. IFS/3000 uses the width of the font 
for VFC, plus any inter-character spacing specified 
with IDSCHAR, to calculate the logical page 
width. IFS/3000 multiplies this total by the 
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number of characters to give the logical page 
width. 


If the font for VFC is proportionally spaced, it is 
inappropriate to specify the logical page width in 
number of characters. If you use a proportionally 
spaced character font for the font for VFC and 
also specify page width in number of characters, 
IFS/3000 uses the maximum cell width of the font 
as the font for VFC width and displays a warning 
message at the bottom of the screen. 


IFS/3000 checks that the character font 
orientation matches the logical page orientation. If 
they do not match, the font is still used as the font 
for VFC, but a warning message is displayed. To 
print in the normal direction of left to right across 
a page, the character font you are using must have 
the same orientation as the logical page you are 
printing on. The character font resident in the HP 
Laser Printer has a landscape orientation. 


Normally it is convenient to use one of the 
character fonts you are using to print your 
document as the font for VFC, but this is not 
required. The width of the font for VFC 1s used 
only for calculation purposes; it is not used during 
the actual printing. 


The actual horizontal spacing used at print time 
depends on the width of the character font selected 
for printing, not the font for VFC width. In 
addition to the character font width, the spacing 
used at print time includes the inter-character 
spacing defined with IDSCHAR. Refer to the 
IDSCHAR’ Reference Guide (Part Number 
36581-90001). If the width of the character font 
selected for printing is larger than the font for 
VFC width, lines may be truncated when printed. 


If you use number of lines (NL) as the unit of 
measurement for logical page height you must also 
specify the font for VFC. IFS/3000 uses the height 
of the font for VFC to calculate the logical page 
height. The font for VFC height multiplied by the 
number of lines gives the logical page height. 


The actual vertical line spacing used at print time 
also includes any inter-line spacing defined with 
IDSCHAR. In contrast to horizontal character 
spacing, vertical line spacing does not depend on 
the character font used for printing (unless you 
choose the "No VFC" option on the VFC Selection 
Menu). 


If you do not specify a value in the Font Number 
for VFC or Name fieid, IFS/3000 selects the initial 
primary character font for the font for VFC. You 
select the primary character font on the Physical 
Page Menu. 


If you do not select a primary character font, 
IFS/3000 uses the character font with the lowest 


$D-number. If there are no character fonts 


defined in the environment, IFS/3000 uses the 
character font resident in the HP Laser Printer as 
the font for VFC. The orientation of this font is 
landscape. 


There may be a special case when you have defined 
character fonts in the environment file, but do not 
want to use any of them for the font for VFC. 
Instead, you may want to use the character font 
resident in the HP Laser Printer. If this is the case, 


THE LOGICAL PAGE MENU 


enter "31" in the Font Number for VFC field. 
IFS/3000 uses this as the font for VFC even 
though you have not defined it in the environment 
file. If you have defined a character font with the 
number 31, the HP Laser Printer default character 
font is no longer accessible. 


6. Actual Spacing 


IFS/3000 displays the width and height of the font 
for VFC in the fields labeled Actual Spacing 
Information. If you do not specify a font for VFC, 
IFS/3000 selects one as described in the paragraphs 
on default font for VFC above. 


IFS/3000 uses the value in the Height field to 
determine line spacing. The Height field 
determines the actual vertical line spacing used at 
print time. In contrast, the actual horizontal 
character spacing used at print time depends on 
the character font being printed, not the value in 
the Width field. If the character font you are 
printing with does not match the size of the font 
for VFC, print lines may be truncated or overlayed 
on top of each other. 


In the Dots character width field, IFS/3000 
displays the width of the font for VFC plus 
inter-character spacing expressed in dots. For 
proportionally spaced fonts, the maximum cell 
width for the font specified is used. 
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The Logical Page Forms Menu 


N Change VFC specification? 


Form 1 Form File 1 (if not default) Scale? Y/N 


Position on Page 





N 
Manual Positioning 
down 
C - em, 


D - dots 


Scale? Y/N 
N 


Figure 3-14. The Logical Page Forms Menu 


on the Logical Page Menu and press (ENTER), the 
Logical Page Forms Menu is displayed. 


You would use this menu to identify up to two 
forms which reside in a forms file that are to be 
associated with the logical page. The data entry 
fields also enable you to specify where you want 
the forms to be positioned on the logical page. 
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Once your environment is compiled, the forms will 
print as part of the logical page layout. 


Review Sections 2, 4, and 5 for information on 
writing data to the forms you have associated with 
a logical page, at print time. 


This menu also provides the menu path to the 


in the Change VFC Specification Field. 


Function Keys 


The function keys used with this menu are: 





Once you type the Form name 
and any associated field data, 
press the key to issue this 
data to the computer. IFS/3000 
will issue status messages to the 
menu banner if any required data 
is not specified, if it cannot access 
the files referenced, or if the 
forms specified are inconsistent 
with the dimensions specified on 


the Logical Page or Physical Page 


Menus. OR, the program will 
issue a bell to indicate that the 
field data was acceptable. The 
menu will remain on the screen 
for your review. You can use the 
function keys to proceed directly 
to another logical page, OR press 
function key to 








return to the Main Menu. 


Pressing (ENTER) again without 
making changes also returns you 


to the Main Menu. 


Press (fi) to. display the 
Logical Page Menu ffor first 
logical page defined. IF you have 
not defined specifications for this 
logical page, the menu will appear 
blank except for the logical page 


ID-number. The Logical Page 


Menu provides the path to the 
Logical Page Forms Menu when 














you specify ¥ in the Change 
Forms or VFC? Field and press 
(ENTER). 


Press (£2) to display the 
Logical Page Menu for last logical 
page defined. IF you have not 
defined specifications for this 
logical page, the menu will appear 
blank except for the logical page 


ID-number. The Logical Page 


Menu provides the path to the 
Logical Page Forms Menu when 
you specify ¥ in the Change 
Forms or VFC? Field and press 
(ENTER). 


Press (CF3 ) to display the 
Logical Page Menu for the logical 


LESS than the current logical 
page. IF you have not defined 
specifications for this logical page, 
the menu will appear blank 
except for the logical page 


IO-number. The Logical Page 


Menu provides the path to the 
Logical Page Forms Menu when 


you specify ¥ in the Change 


Forms or VFC? Field and press 
(ENTER). 


Press to display the 
Logical Page Menu for the logical 


GREATER than the current 
logical page. IF you have not 
defined specifications for this 
logical page, the menu will appear 
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blank except for the logical page 


$D-number. The Logical Page 


Menu provides the path to the 
Logical Page Forms Menu when 
you specify ¥ in the Change 
Forms or VFC? Field and press 
(ENTER). 


Press (fA6_) to redisplay the 
terminal screen with any data 


entered using the key. 








Press to return to the 
Main Menu. Note that any field 
data you have typed but have not 
entered will be lost. 





Press to delete any data 
you have just typed, but have 
decided not to enter. 


Field Discussion 


There are six groups of data entry fields on the 
Logical Page Forms Menu. 


The first field is used to specify that you wish to 
proceed to the Vertical Format Control Menu. 
The remaining fields enable you to identify the 
forms to be associated with the logical page, and to 
specify the position of the form on the logical 
page. These fields are repeated on the menu to 
enable you to specify two forms to be associated 
with the logical page. 


IF you do not change the default position field, 
IFS/3000 automatically centers each form ON the 
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logical page. IF you also specify that the forms be 
scaled, they will be centered WITHIN the printable 
area of the logical page. 


Where you have specified two forms, the forms can 
be positioned independently, or overlay each other 
partially or completely. You can combine the 
Position On Page Field with the Manual 
Positioning Field to provide precise control on 
forms placement on the logical page. 


When you have specified the field data and press 
CENTER), IFS/3000 will display status messages to 
the menu banner if it encounters inconsistencies as 
follows: 


e The form has been positioned such that part of 
the form extends beyond the limits of the 
logical page. 


e The form has been positioned such that part of 
the form extends into the unprintable border 
area of the physical page. 


e The form is too large to fit on the physical 
page. 


The field data and its effect on the environment is 
defined in the following discussions for Form 1. 
The fields repeat on the menu for Form 2. The 
same definitions apply to the Form 2 Fields. 


1. The Change VFC 
Specification Field 


The default for this field is § (=no). IF you want 
to proceed to the Vertical Format Control Menu, 
you MUST change N to ¥ (=yes) and press (ENTER). 
You do not need to specify any other field. 






2. The Form 1 Field 


Form 1 





This field is used to identify the form you wish to 
associate with the logical page. The form’s name is 
the name assigned when it was created in 
IDSFORM. The form name can contain up to 16 
characters, beginning with a letter, followed by 
any letter or number. 


If the form does not exist in the form file specified, 


IFS/3000 displays an error message in the menu 
banner. 


3. The Form File 1 Field 


Form File 1 (if not default) 





This field is optional if you elected to specify a 
default forms file on the Physical Page Menu, and 
it contains the forms you wish to identify in the 
Form | Field on this menu. You can override the 
default forms filename by specifying a filename 
for any form which does not reside in the default 
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forms file. IF you do not use the default forms 
file you MUST specify the forms filename in this 
field. 


Normally all forms created using IDSFORM for a 
specific environment are stored in the same forms 
file. 


You enter the name of the forms file using 
standard MPE File System naming conventions 
where the filename may have up to 8 characters, 
and can be any letter followed by any letter or 
number. If the file resides in a group other than 
the sign-on group, you must also specify a 
groupname and accountname. You may also 
specify a lockword if this form of security applies 
to the file. 


If you need to use all of these file designation 
conventions, the field data entry would appear as 
follows: 


Form File 1 (if not default) 





When you press (ENTER), the IFS/3000 program 
checks to see that the filename specified exists, 
that it is a forms file, and that the form name 
resides within the file. The form definition is then 
included in the environment file and will be 
compiled when you perform that operation using 
the Main Menu. 


If the file does not exist as specified, a status 
message will be issued indicating that: 


e The filename does not meet MPE filename 


conventions. 
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e The file does not reside in the group and 
account specified. 


e You cannot access the file due to security 
violations. 


© The form name does not exist within the file. 


e The file specified is not a forms file. 


4. The Scale? Field 


Scale? Y/N 


IF you do not scale a form, the form is centered 
ON the logical page. IF you scale a form, the form 
is centered WITHIN the printable area on the 
logical page. Scaling is proportional. 


You should determine if your form includes 
borders which are to extend beyond the printable 
area of the logical page, or if the entire form is to 
be positioned within the printable area. You 
cannot write data to any part of a form which 
extends beyond the printable area defined in a 
logical page layout. 


In addition, when a form is scaled, IFS/3000 does 
not scale character fonts and logos in the same way 
it scales the lines and boxes in a form. Instead, it 
selects the font point size or logo which is as close 
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as possible to the scaling of the rest of the form. If 
the available font selection does not include an 
appropriate size, the text embedded in the form 
may not be positioned properly. You should 
therefore use care when scaling forms. 


5. The Position On Page Fields 


Position on Page 





other = field position. Reading from left to right, 


the positioning of the form on the logical page is 
defined as follows: 


Top: left, center, right 





Center: left, centered, right 





Bottom: left, center, right 


By placing an X in the top left field, your form 
would be positioned in the upper left corner of the 
logical page. By placing an X in the centermost 
field of the center line, your form would be 
positioned in the center of the logical page. 


You can adjust this positioning. field by also 
specifying the Manual Positioning Field. 


6. The Manual Positioning Field 


Manual Positioning 

Distance to move right 

Distance to move down 

Units: I - IN, C - CM, 
M- MM, D - Dots 





This is an optional data entry field group. There 
are three fields in this positioning group. You use 
the first two to specify the number of units to 
move the form on the logical page. You use the 
third field to specify the value of the units. 


IF you do not enter specifications in these fields, 
IFS/3000 defaults to the Position On Page Field. 
You can use the Manual Positioning field to offset 
from the automatic Position On Page Field entry. 
Any time you enter data in these fields which is 
inconsistent with the limitation of the logical page 
or physical page, the program will issue status 
messages to the menu banner. 


The effect of this field data is defined as follows: 


Distance to move right 





The number you specify in this field 
can be either a positive or negative 
whole number or whole number and 
decimal fraction; if appropriate to the 
units specified in the associated Units 
Field. 
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The number you specify here will 
reposition the form starting at the 
position indicated in the Position On 
Page Field. This field moves the 
form to the right the number of units 
entered in this field, calculated at the 
value you specify in the associated 
Units Field. IF you specify a 
negative number, the form is moved 
to the left. 


Distance to move down 


The number you specify in this field 
can be either a positive or negative 
whole number or whole number and 
decimal fraction; if appropriate to the 
units specified in the associated Units 
Field. 


The number you specify here will 
reposition the form starting at the 
position indicated in the Position On 
Page Field. This field moves the 
form down the number of units 
entered in this field, calculated at the 
value you specify in the associated 
Units Field. IF you specify a 
negative number, the form is moved 
up. 
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The number you specify in these positioning fields 
will be calculated in the unit value you specify in 
the Units Field. The alternates to the Units Field 
are defined as follows: 


IN 


This alternate will calculate the number you 
specify in INCHES. 


CM 


This alternate will calculate the number you 
specify CENTIMETERS. 
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MM 


This alternate will calculate the number you 
specify MILLIMETERS. 


Dots 


This alternate will calculate the number you 
specify in the number of dots specified. 
Refer to the operator’s manual for the device 
you specified in the Device Field on the Main 
Menu to review the number of dots per inch 
when specifying this alternate. 


Field groups 2 through 6 above are repeated on the 
menu to allow you to load 2 forms on a single 
logical page. 


The Vertical Format Control Menu 


S - Standard, automatically computed VFC 
|} lines before first line 
i lines after last line 


F - Special VFC from a file 
VFC Fil 


N - No VFC (space according to character height) 
Top margin 
Units I - IN, Cc - 





CM, M - MM, D - Dots 


Figure 3-15. The Vertical Format Control Menu 


If you enter ¥ in the Change VFC Specification? 
Field on the Logical Page Forms Menu and press 
(ENTER), the Vertical Format Control Menu is 


displayed. 


The number of lines of print and the amount of 
blank space between the lines establishes the 
vertical format control for the logical page. Each 
print line represents a horizontal channel with a 
vertical height which you specify as equal to a font 


cell size or specific unit height. You define these 
VFC specifications on the Logical Page Menu. 


You would use this menu ONLY IF you want to 
change the default method of computing VFC or 
provide additional specifications for an alternate 
method. 


Your environment may contain a number of 
character fonts in various point sizes. The Laser 
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Printer enables you to vary the fonts and point 
sizes within each channel of print on a logical 
page. When the range of font point sizes 1s 
extreme, you may need to define a logical page 
where the VFC has been adjusted to accommodate 
specific point sizes. This menu enables you to 
specify a unique VFC for any logical page. 


Function Keys 


The function keys used with this menu are: 
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Once you type VFC selection and 
any associated field data, press the 
key to issue this data to 
the computer. IFS/3000_ will 
issue status messages to the menu 
banner if it has difficulty 
processing the VFC. OR, the 
program will issue a bell to 
indicate that the field data was 
acceptable. The menu will 
remain on the screen for your 
review. You can use the function 
keys to proceed directly to 
another logical page. OR, IF you 
do not make any changes, you can 
press again, OR press the 
function key to return 
to the Main Menu. 





Press Cf1_) to display the 
Logical Page Menu for first 
logical page defined. IF you have 
not defined specifications for this 
logical page, the menu will appear 
blank except for the logical page 


ED-number. The Logical Page 











Menu provides the path to the 
Vertical Format Control Menu 


Forms or VFC? Field and press 
(ENTER). 


Press (42) to display the 
Logical Page Menu for last logical 
page defined. IF you have not 
defined specifications for this 
logical page, the menu will appear 
blank except for the logical page 


EO-number. The Logical Page 


Menu provides the path to the 
Vertical Format Control Menu 


Forms or VFC? Field and press 
(ENTER). 


Press C/3_) to display the 
Logical Page Menu for the logical 


LESS than the current logical 
page. IF you have not defined 
specifications for this logical page, 
the menu will appear blank 
except for the logical page 


tD-number. The Logical Page 


Menu provides the path to the 
Vertical Format Control Menu 


Forms or VFC? Field and press 
(ENTER). 


Press (74) to display the 
Logical Page Menu for the logical 


GREATER than the current 
logical page. IF you have not 


defined specifications for this 
logical page, the menu will appear 


EO-number. The Logical Page 


Menu provides the path to the 
Vertical Format Control Menu 


when you specify ¥ in the Change 


Forms or VFC? Field and press 
(ENTER). 





Press (fs) to redisplay the 
terminal screen with any data 


entered using the key. 


Press to return to the 
Main Menu. Note that any field 
data you have typed but have not 
entered will be lost. 








Press to delete any data 
you have just typed, but have 
decided not to enter. 


Field Discussion 


There are four groups of data entry fields on the 
Vertical Format Control Menu. 


The first field is used to specify the method to be 
used to compute the VFC for the current logical 
page. The remaining fields are used to specify 
data that may be required to perform the 
computation for the method selected. 


The field data and its effect on the environment is 
defined as follows: 
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1. The Type of VFC Field 


The default for this field is § (=Standard). You 
may select an alternate method of computing VFC 


by changing the § to either of the other alternates. 
All alternates for this field are defined as follows: 


§ tandard, automatically 

computed VFC 
This selection is the default method of 
computing VFC. This method automatically 
computes the VFC using the specifications 
entered on the Logical Page Menu as follows: 


® The logical page height is divided by the 
number of lines specified in the 
Overriding Line Spacing Field if 
overriding line spacing is defined. 

OR, 

o The logical page height is divided by the 
height of the character cell for the font 
for VFC specified in the Font Number or 
Font Name For VFC Field if font for 
VFC is defined. 


OR 


bf 


e The logical page height is divided by the 
height of the lowest number character 
font if a character font is defined. 


OR, 
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« The logical page height is divided by the 
height of the font resident in the HP 
Laser Printer. 


This calculation determines the number of 
channels reserved for print, with blank line 
spacing of equivalent size between each of 
the print lines. 


Special VFC from a file 


You would use this method if your 
environment has to be compatible with an 
existing program which uses a special VFC. 
The user-defined VFC must be contained in 
a standard ASCII file containing 80 byte 
records. The associated VFC File Field is a 
required field when selecting this method. 
Refer to the VFC File Field discussion in this 
section. Refer to Appendix E for discussions 
and examples of user-defined VFC 
specifications. 


NOTE | 


The user-defined VFC file provides 
programmatic access to print 
positioning by establishing a VFC 
table with predefined channel 
positions. The height of the channel 
and the line spacing between channels 
is caiculated in the same procedure as 
defined in the Standard VFC 
discussion above. Therefore, the 
specifications you enter on the 
Logical Page Menu are required in 
order to use this method of VFC 
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computation; OR, defaults for the 
Logical Page Menu Fields will apply. 


N No VFC (space according to 
character height) 

This selection does not use the Overriding 

Line Spacing or Font Number or Font Name 

Field specifications on the logical page menu. 


It provides the most flexibility of the three 
methods by determining the line spacing 
based on the height of the character cell 
being written to the logical page. If the 
character point size does not change within a 
page, the number of lines is determined by 
dividing the logical page height by the 
current character cell height. However, if 
the character point size in the last character 
position on « line has a different character 
cell height than the initial character point 
size, the remainder of the logical page is 
recalculated until another point size is 
encountered in the last position on a line, or 
the page 1s filled. 


2. The Line Position Fields 


lines before first line 
lines after last line 





These two fields are associated with the § Standard 
VFC method alternate. Each field has a default 





The number specified in these fields determines the 
beginning and ending print positions within the 


printable area on the logical page. The default 
number sets the beginning position after the third 
line, and leaves three blank lines at the bottom of 
the printable area. If is helpful to remember that 
the printable area on a logical page may not be the 
same as the size of the logical page. 


The number of channels (lines) available for print 
is reduced by the total number of lines entered in 
these fields. 


You can change the default | by entering 
to begin printing on the first line available and 
continuing through the last line; OR, you may 
specify any combination of lines to be skipped 
before the first line of print and after the last line 
of print. 





3. The VFC File Field 


Field and is a required field when using this 
method. 


You enter the name of the VFC file you wish to 
use in this field. You must use standard MPE File 
System naming conventions, where the filename 
may have up to 8 characters, and can be any letter 
followed by any letter or number. If the file 
resides in a group other than the sign-on group, 
you must also specify a groupname and 
accountname. You may also specify a lockword if 
this form of security applies to the file. 


If you need to use all of these file designation 
conventions, the field data entry would appear as 
follows: 
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When you press (ENTER), the IFS/3000 program 
checks to see that the filename specified exists, and 
that is it contains a valid VFC format. If the file 
does not exist as specified, a status message will be 
issued indicaiing that: 


© The filename does not meet MPE filename 
conventions. 


e The file does not reside in the group and 
account specified. . 


e You cannot access the file due to security 
violations. 


© The file does not contain information in the 
required VFC format. 


4. The Top Margin Field 





@ Top Margin 
| Units 


There are two fields in this group and both are 
associated with the N - No VFC Field alternate. 


) (=zero), 





typing your specifications in the fields. 


The top margin is specified as a whole number, or 
as a whole number with a decimal fraction if 
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appropriate to the units specified in the associated i MM 
Units Field. 


This alternate will calculate the number you 


The number you specify in the Top Margin Field specify in the Top Margin Field in 
will be calculated in the unit value you specify in MILLIMETERS. 
the Units Field. The alternates to the Units Field 
are defined as follows: Dots 
I IN This alternate will calculate the number you 
specify in the Top Margin Field in the 
This selection is the default value for this number of dots specified. Refer to the 
field. The number you specify in the Top operator's manual for the device you 
Margin Field will be calculated in INCHES. specified in the Device Field on the Main 
Menu to review the number of dots per inch 
c CM when specifying this alternate. 


This alternate will calculate the number you 
specify in the Top Margin Field in 
CENTIMETERS. 
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Character Font: 
Number ¢ 
Name (user defined) 
File 


Point size -OR- 


Cell height in dots -OR- 
Height of Capital letters 


— Units: I - IN 
M - MM 





ASCII Character code: Lowest 





Proportional spacing: _ Point 
Size 


Actual size to be used .......... 
Next Larger size available ...... 
Next smaller size available ..... 











Orientation 
L - Landscape 
P - Portrait 
RL - Reverse Landscape 
RP - Reverse Portrait 





N - Nearest 
S - Smaller 
L - Larger. 
Ht of Cell Cell 
Capitals Width Height Baseline 


—e ——— 
eee mmemiee 
—— es 





Figure 3-16. The Character Font Menu 





If you enter in the Main Menu Selection field 
and press (ENTER), the Character Font Menu is 
displayed. 


You use this menu to identify the character fonts 
or logos you wish to include in your environment. 
OR, to review or modify fonts or logos in an 
existing environment; OR which you copied using 
the Copy or Initialize Menu. 


When you associate your environment with a data 
file, The Laser Printer activates or deactivates the 
character fonts you have specified with this menu 
as instructed by the data file or application 
program. It is suggested that you review the 
IDSCHAR Terminology in Section 2. This will be 
helpful in specifying the data entry fields on this 
menu. It will also be useful when determining the 
effect of your environment on your data file at 
print time. 
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The function keys used with this menu are: 
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Once you type the Character Font 
filename and all other required 
field data, press the key 
to issue this data to the computer. 
IFS/3000 will issue status 
messages to the menu banner if 
any required data is not specified, 
or if it has difficulty processing 
the data. OR, the program will 
issue a bell to indicate that the 
field data was acceptable. The 
menu will remain on the screen 
for your review. You can use the 
function keys to proceed directly 
to another character font. OR, IF 
you do not type any changes, you 
can press again, OR press 
function key, to 
return to the Main Menu. 





Press (71) to display the first 
font defined. IF you have not 
defined specifications for this 
character font, the menu will 
appear blank except for the font 
}D-number and field defaults. 


Press (_£2__) to display the last 
font defined. IF you have not 
defined specifications for this 
character font, the menu will 
appear blank except for the font 


1D-number and field defaults. 

















Press (f3_) to display the 
character font with an 


tOD-number ONE LESS than the 


current character font. IF you 
have not defined specifications 
for this character font, the menu 
will appear blank except for the 


font &O-number and field 


defaults. 


Press to display the 
character font with an 
TD-number ONE GREATER 
than the current character font. 
IF you have not defined 
specifications for this character 


font, the menu will appear blank 


and field defaults. 


Press (6 _) to redisplay the 
terminal screen with any data 


entered using the key. 


Press to return to the 
Main Menu. Note that any field 
data you have typed but have not 
entered will be lost. 


Press to delete:any data 
you have just typed, but have 
decided not to enter. 


Field Discussion 


There are nine groups of data entry fields on this 
menu. | 

The first field establishes the FB-number for the 
character font specifications you are entering or 
reviewing on the menu. This ID-number remains 
associated with the specifications unless you 
change it. It enables you to identify individual 
character fonts in a data file or application 
program which can then be activated or 
deactivated by the Laser Printer at print time. 





The second field is used to establish the orientation 
of the character font in relation to the physical 
page. You must define a separate character font 
for each orientation you wish to include in your 
environment. 


The third field enables you to provide an optional 
font name. This is useful where you prefer to use 
your own naming conventions by supplying a font 
name that is more descriptive of your application 
than the font file name. 


The remaining fields are used to specify the file 
where the character font resides, the size of the 
character, what alternate sizes are acceptable, and 
whether you wish to save space in the environment 
by specifying a range of characters to be included. 


The menu is divided into two sections by a dashed 
coo-- line. The protected fields below this line 
are used by the program to display the font 
characteristics that the program finds in the file 
when you press the key. Once you have 
reviewed this information you would re-type any 
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changes in the data entry fields above the line, and 


press (ENTER). 


You may respecify any data on this menu until the 
data is acceptable. 


The field data and its effect on the environment is 
defined as follows: 


1. The Font Number Field 


Character Font: 


This is a required field. You can identify up to 32 
sets of character font or logo specifications to be 
included in your environment. Each font or logo 
MUST be defined individually and given an 


appear in this field when the Character Font Menu 
is displayed. The number that appears depends on 
the method you use to display the menu as follows: 


e IF you DID NOT enter a specific font number 
in the Font/Page Number, OR Character Font 


displayed. If you have not defined 
specifications for this font number the menu 





and field defaults. 


e IF you DID enter a specific font number in the 
Font/Page Number, OR Character Font Name 
Field on the Main Menu; the font number 
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entered, or number associated with the name 
entered will be displayed. If you have not 
defined specifications for this font number, the 
menu will appear blank except for the 


FO-number and field defaults. You can not 


specify a font name unless you have already 
defined the font specifications and used the 


ENTER) key. 


e IF you used a function key on this menu, the 


label will be displayed. Refer to the function 
key discussions. 


you wish to assign a different number than the 
number currently assigned on the menu. 


over the number in this field before using the 
key. This makes an exact duplicate so you may 
want to delete the copied font. 


NOTE 


IF an existing font specification is similar 
to a new font you want to include in your 
environment, you can change’ the 


iO-number and font name and use the 
current size specifications without having 
to retype them. You would also provide a 
new filename if the font resides in another 


file. 
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that is currently defined and press (ENTER), 
the program will ask you to confirm that 
you want to overwrite the existing 
specification. IF you do so, the existing 
specification will be lost. You should 
exercise caution when reassigning font 


The font number is used by IFS/3000 to provide 
access to an individual set of font specifications 
when working with an environment file. The font 
number is used by the Laser Printer to locate and 
activate or deactivate the compiled font. The font 
number is identified in the data file or application 
program along with instructions to the Laser 
Printer as to when the font number is to be 
activated or deactivated. When a font is active, 
the data file prints in the active font. 


2. The Orientation Field 


Orientation 





This is a required field. You use this field to 
specify the orientation of the character font in 
relation to the physical page. The orientation of 
the logical page is device dependent, specific to the 
device you identified in the Device Field on the 
Main Menu. You must define a separate character 
font for each orientation of a font you wish to 
include in your environment. 


The alternate character font orientations you may 
specify in this field are defined as follows: 


Landscape 


Portrait 





Reverse Landscape 


RP Reverse Portrait 


Refer to Section 2, figure 2-6 for examples of the 
above orientations. 


3. The Font Name Field 


Name | (user defined) 





This is an optional field. You would use this field 
to provide a descriptive font name. This is useful 
where you wish to use a name which you feel is 
easier to remember, or is more descriptive of the 
font in its current application. 


You can use the name you specify here in the 
Character Font Name Field on the Main Menu to 
access the specifications you define on this menu. 


The Laser Printer does not use the font name when 
identifying fonts. Any instructions associated with 
a data file or application program must interpret 


The font name may include up to 16 characters, 
beginning with a letter, followed by any letter or 
number. A common usage identifying a font ina 
12 point size and bold typeface could be entered as 
follows: 
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Name : | (user defined) 


4. The Font File Fieid 


File 





This is a required field. You use this field to 
identify the character cell file where the font or 
logo resides. 


You enter the name of the character font file 
using standard MPE File System naming 
conventions where the filename may have up to 8 
characters, and can be any letter followed by any 
letter or number. If the file resides in a group 
other than the sign-on group, you must also 
specify a groupname and accountname. You may 
also specify a lockword if this form of security 
applies to the file. 


If you need to use all of these file designation 
conventions, the field data entry would appear as 
follows: 





When you press (ENTER), the IFS/3000 program 
checks to see that the filename specified exists, 
that it is a character font file, and that the font 
size defined in the associated font size field resides 
within the file. The character font definition is 
then included in the environment file and will be 
compiled when you perform the compile operation 
using the Main Menu. 
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If the file does not exist as specified, a status 
message will be issued indicating that: 


e The filename does not meet MPE filename 
conventions. 


* The file does not reside in the group and 
account specified. 


e You cannot access the file due to security 
violations. 


e The character font size does not exist within 
the file. 


e The font is inconsistent with the device 
specified in the Device Field on the Main 


Menu. 


e The file specified is not a character font file. 


5. The Font Size Fields 


Point size -OR- 
Cell height in dots -OR- 
Height of Capital letters 





There are three alternate fields in this group. You 
MUST use ONE of the alternates to specify the size 
of the character font you wish to include in your 
environment. 


A character font file contains all characteristics of 
a character font, including its cell point size, cell 
height, and dot equivalents. A font is also device 
dependent as the dot pattern required to form a 
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letter depends on the dot density for the printer 
hardware. 


You use ONE of these fields to specify the font size 
in the characteristic you have available. 


You would use the associated Match Size Field to 
indicate the next size which would be acceptable if 
the actual size specified is not available in the font 
file. When you press the key, the program 
will issue a bell if the font size requested is 
available. In addition, all of the characteristics of 
the font size will be displayed in the protected 
fields below the dashed ----- line. This 
information will appear on the line which 
indicates the actual size to be used. 


If the size requested is not available, a status 
message will be issued and the alternate sizes 
available in the file will be displayed in the 
protected fields below the dashed ----- line. The 
alternate sizes displayed are within the limits of 
your entry in the Match Size Field. Once you 
have reviewed this information, you would re-type 
any changes in the font size field above the line, 


and press (ENTER). 


The alternates for the font size fields are defined 
as follows: 


Point size 


The point size is the standard 
measurement used to designate font 
sizes and is normally the most 
frequently used field for this 
specification. 





The point size is determined by the 
character designer at the time the 
character font is created using 
IDSCHAR. OR, the point size is 
included in the listing of character 
fonts supplied by Hewlett-Packard in 
Appendix D. You would type the 
point size in this field as a whole 
number. A 12 point font would be 
specified as follows: 


Point size 





The program will look for the point 
size in the character font file you 
identified on this menu. 


Cell height in dots 


This selection requires that you 
define the character cell height in 
dots. Since character fonts are device 
specific, you must define this field for 
the device entered in the Device Field 
on the Main Menu. 


The dot height is determined by the 
character designer at the time the 
character font is created using 
IDSCHAR. OR, the dot height is 
included in the listing of character 
fonts supplied by Hewlett-Packard in 
Appendix D. You would type the dot 
height in this field as a whole 
number. 


To specify the cell height in dots for 
a 12 point font and a } i Device, 
this field would be defined as follows: 
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Cell height in dots 








Cell height in dots 


The program will look for the cell 
height in the character font file you 
identified on this menu. 


Height of Capital Letters 


If you do not know the point size or 
the height of the character cell in 
dots, you can measure the height of a 
capital letter and enter it in this 
field. The height can be expressed as 
a whole number or whole number 
and decimal fraction. A _ capital 
letter that measures .198 inches 
would be specified as follows: 





Height of Capital 
letters 


The program will calculate this 
dimesion in the units specified in the 
associated Units Field. It determines 
the equivalent height in dots for the 
device specified in the Device Field 
on the Main Menu. It then looks for 
the dot height of capitals in the 
character font file you identified on 
this menu. 
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6. The Match Size Fieid 


(=Larger). 


This field establishes what alternative information 
is to be displayed in the protected fields below the 
dashed ----- line on the menu. When you specify 
a font size field and press the key, the 
program will display the actual font characteristics 
if there is a match. If it cannot find the exact size 
specified, it will display the next smaller or next 
larger font characteristics which also resides in the 
file. If no alternatives are available, the program 
will issue a status message. 


7. The Units Field 


= Units: I - IN 

M - MM 
This is an optional field UNLESS you have 
specified the associated Height Of Capital Letters 


The unit value you specify in this field is used to 
calculate the height of the capital letter. The 
alternates to the Units Field are defined as follows: 


i IN 


This alternate will calculate the number you 
specify in INCHES. 
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Fe MM 


This alternate will calculate the number you 
specify in MILLIMETERS. 


8. The ASCIl Character Code 
Fields 





Lowest 





Highest 


There are two data entry fields in this group. 
These are optional fields. 


The Lowest and Highest Character Code fields are 
used to specify the range of characters you want to 
include in the environment. This enables you to 
minimize the space required for your environment 
file, both on disc and in Laser Printer memory. 


Each character in a character font has a character 
code number associated with it. If you do not need 
all the characters in a given character font, you 
can enter the range of character codes you want to 
use in printing your document. Your environment 
file then includes only the characters with 
character code numbers in the range you specify. 


If you do not type anything in these fields, the 
system defaults to the entire range of characters 
between character code numbers 32 and 126 
inclusive. Normally the character code number 
assigned to a character is the ASCII code. In 
ASCII, character code numbers 32 through 126 
include the upper and lower case alphabet, the 
integers O through 9, and several common 
punctuation symbols. Character number 32 is a 
space. If the characters in a character font were 


not defined as ASCII characters, these character 
code numbers may result in characters other than 
those just described. 


To include the ASCII characters between 32 and 
58, the entry would be as follows: 





Highest 


If the character font is a logo file, IFS/3000 
automatically supplies the number 76 as the value 
for both the Lowest and Highest Character Code 
fields. A logo file contains only one character 
which is always assigned character code number 
76, the uppercase letter "L" in ASCII. 


9. The Protected Information 
Fields 


There are six protected display fields in this group. 
Five of the fields provide space for displaying three 
sets of information. 


The information in Section 2 on IDSCHAR 
terminology will be useful in determining how to 
apply the data displayed in these fields. 


Proportional spacing: N Point 
Size 
6.00000 
8.00000 
6.00000 


Actual size to be used. . 
Next Larger size available. 
Next Smaller size available. 
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When you type the font filename and font size you 
wish to locate in the file, and press (ENTER); 
IFS/3000 uses these fields to display actual and 
alternate information. Once you review this 
information and type any changes in the data 
entry fields above the dashed ----- line, press 
(ENTER). The information displayed here enables 
you to review the alternates within the file and 
modify your specification until the font is defined 
successfully. 


An example of the information displayed in these 
fields follows. 


The first information field displays if the 
character font is proportionally spaced (Y=yes, 
Neno). The other fields vary in the information 
they supply. 


If you select a point size that does not exist in the 
character font selected, the information displayed 
will show you the actual size to be used along with 
the next larger size and next smaller size available 
and the baseline of each. The sizes displayed may 
not be the only ones resident in the cell file. For 
example, you might select 7 as the point size and, if 
it does not exist, the information displayed might 
be as follows: 


Ht of Cell Cell 

Capitals Width Height Baseline 
055556 7 15 5 

. O66667 10 20 6 
.055556 7 15 5 


Jan 84 
3-73 


THE CHARACTER FONT MENU 


If you change your selection from 7 to 10 and size 10 does not exist, the information displayed might then be 
as shown below: 


Proportional spacing: N Point Ht of Cell Cell 

Size Capitals Width Height Baseline 
Actual size to be used. . . 8.00000 .066667 10 20 6 
Next Larger size available. 12.00000 .094444 15 30 10 
Next Smaller size available. 8.00000 .066667 10 20 6 


Lastly, if you select a point size that does exist in the character font selected, the information displayed would 
show only the actual size to be used. 


Proportional spacing: N Point Ht of Cell Cell 
— Size Capitals Width Height Baseline 
Actual size to be used. .. 12.00000 .094444 15 30 10 


Next Larger size available. 
Next Smaller size available. 


For proportionally spaced characters, IFS/3000 displays the maximum cell width. Without proportional 
spacing, the character cell width is the same for each character in a given character font. If you know the 
cell width and the page size, you can calculate the number of characters that can be printed in a line on the 


page. 


The cell width does not include any inter-character spacing which may have been specified when the cell was 
defined using IDSCHAR. Refer to the IDSCHAR Reference Guide (Part Number 36581- 90001). 


The cell height does not include any inter-line spacing which may have been specified when the cell was 
defined using IDSCHAR. Refer to the IDSCHAR Reference Guide. 


The baseline is a line used for reference purposes when designing characters; it is not an actual line to be 
printed along with the character. A character or logo sits on its baseline. When characters are printed, they 
are aligned according to the baseline. All capital and lower case letters, except for the descender, should sit on 
the baseline. The character designer specifies the location of the baseline during the character design process. 
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The Copy Menu 


|= Parts to Copy 
C - Character fonts, -OR- 


L - Logical pages, -OR- Number 
P - Physical page and environment defaults 
E - Entire environment 


k Method of Copy 


Number 


-OR- 


O - Overwrite ... Copies all items, deleting the existing values. 


R - Replace 
A - Add 
F - Fill 


parts? Y/N 





all items found in both environments. 
all items, renumbering if necessary. 
only those items not already in this environment. 


Figure 3-17. The Copy Menu 


If you enter & 
the Copy Menu 1s displayed. You use this menu to 
copy all or part of an another environment file 
into the environment you are working on. An 
environment file contains two types of data: 





e The physical page, logical page(s), and character 
font(s) specifications. 


e The compiled version of these specifications. 


The Copy Menu enables you to copy an 
environment specification with or without the 
corresponding compiled part. It also enables you to 
identify a single specification to be copied. 


Any specifications and compiled parts which are 
added to your environment using the Copy Menu 
will be detected as a change by the IFS/3000 
program. When you specify the compile function 
on the Main Menu, they will automatically be 
recompiled. 
Jan 84 
3-75 


Function Keys 


The function keys used with this menu are: 
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Once you have typed the 
environment file name and the 
associated data in the menu fields, 
press the key to issue the 
field data to the computer. 
IFS/3000 will issue status 
messages to the menu banner if it 
has difficulty accessing or copying 
the specified environment. The 
program will issue a bell if the 
operation is successful. The menu 
will remain displayed for you to 
copy additional parts from the 
designated file or from another 
environment file. If you do not 
specify any new data, you can 
press again, OR press the 
function key to return 
to the Main Menu. 





Press to redisplay the 


terminal screen with any data 


entered using the key. It 
is useful when you have used the 





Press to return to the 
Main Menu. Note that any field 
data you have typed but have not 
entered will be lost. 


Press to delete any data 
you have just typed, but have 
decided not to enter. 


Field Discussion 


There are four groups of data entry fields on the 
Copy Menu. 


You use these fields to specify the environment file 
you wish to copy from, the parts you wish to copy, 
the method you want used when the part is copied, 
and to indicate whether or not the associated 
compiled part is to be copied along with the 
specifications. 


You may respecify any field data which results in 
a warning or error message, until the copy 
operation is successful. 

The field data and its effect on the environment is 


defined as follows: 


1. The Environment File to Copy 
From Field 


Environment file to co fr 








This is a required field. You must also specify the 
Parts to Copy field before you press (ENTER). You 
do not have to change the default values for the 
Method of Copy or Copy Associated Parts fields 
unless you wish to choose an alternate selection. 


You enter the name of the environment file you 
wish to copy from in this field. You must use 
standard MPE File System naming conventions, 
where the filename may have up to 8 characters, 
and can be any letter followed by any letter or 


number. If the file resides in a group other than 
the sign-on group, you must also specify a 
groupname and accountname. You may also 
specify a lockword if this form of security applies 
to the file. 


If you need to use all of these file designation 
conventions, the field data entry would appear as 
follows: 


Environment file to copy from 





When you press (ENTER), the IFS/3000 program 
checks to see that the filename specified exists, 
that it is an environment file, and that the part to 
be copied is available. If the file does not exist as 
specified, a status message will be issued indicating 
that: 


e The filename does not meet MPE filename 
conventions. 


® The file does not reside in the group and 
account specified. 


e You cannot access the file due to security 
violations. 


e The part to be copied does not exist as specified. 


@ The file specified is not an environment file. 
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2. The Parts To Copy Fields 


= Parts to Copy 


Number 








- Name 


There are three data entry fields in this group. 
The first field is used to select the parts you wish 
to copy. This selection will determine if you can 
use the other two fields to specify a logical page or 


font name. These three fields enable you to 
specify exactly what you want to copy into your 
current environment. 


Your alternate selections for these fields are 
defined as follows: 


~OR- FO Number 


~OR- 4 





Name 


This selection enables you to copy ALL 
character fonts in the specified environment: 
OR, also specify a single character font 
iO-number or name in the associated fields. 


If you wish to copy a number of individual 
character fonts, you would need to repeat the 
G copy procedure for each character font, 


using the Number or Name fields. OR, you 
could copy all fonts, and then use the Main 
Menu to delete the ones you did not want to 
include in the current environment. 


When this copy operation is complete, you 
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would use the Character Font Menu to 
display or modify the copied specifications. 


all Logical pages 
-OR- £0 Number 


This selection enables you to copy ALL 
logical pages in the specified environment: 
OR, also specify a single logical page 


iO-number in the associated field. 


If you wish to copy a number of individual 


copy procedure for each logical page using 
the Number field. OR, you could copy all 
logical pages, and then use the Main Menu to 
delete the ones you did not want to include 
in the current environment. 


When this copy operation is complete, you 
would use the Logical Page Menu to display 
or modify the copied specifications. 


Physical page and environment 
defaults 


This selection enables you to copy the 
physical page specifications in the specified 
environment. Since the physical page defines 
all other environment defaults, this selection 
will establish the current environment’s 
defaults. 


In addition, any multi-copy forms associated 
with the physical page will be copied. 


When this copy operation is complete, if you 
display the Physical Page Menu, the number 
of physical page copies, multi-copy forms, 
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and primary and secondary character font 
specifications will have the same values as 
those in the environment you copied. 


Any time you add or modify the physical 
page specifications, IFS/3000 will notice the 
change and automatically require you to 
compile or recompile all other specifications 
in the environment. 


Entire environment 


This selection enables you to copy all 
specifications in the specified environment. 
If you also specify that the copy method is to 
overwrite any existing specifications, the 
effect will be the same as if you had used the 
Initialize Menu. 


3S. The Method Of Copy Field 


The default for this field is ® (=Replace). You do 


not need to change this default unless you wish to 
select another method of copy. 


You use this field to select the procedure to be used 
when the program copies the designated parts. In 


(=Replace) to the selection desired. 


Your alternate selections for this field are defined 
as follows: 


Overwrite 


This selection will replace any existing 
specifications for the same part with the 
copied specifications. The part or parts 
replaced are those identified in the Parts to 
Copy fields. 





Be careful when selecting the parts 
to be copied. IF you do not specify a 
single font or logical page, AND you 
also select this method of copying, 
any existing font or logical page 
specifications which do not also exist 
in the designated environment will be 
deleted from the current 
environment. The results will be 
that the current environment will 
ONLY contain specifications which 


THE COPY MENU 


were present in the environment you 
copied. 


Replace 


This is the default value for this field. This 
selection will replace corresponding 
specifications in the current environment 
with the copied specifications. The parts 
replaced are those identified in the Parts to 
Copy fields. If you have specified that all 
parts be copied using this method, any 
current part that does not have a 
corresponding part to be copied WILL NOT 
be deleted. Once you replace a part, you 
cannot retrieve the previous data. 


Add 


This selection will add the specified part to 
the current environment. If the logical page 
or character font #0 

already is assigne in the current 
environment, the copied part will be 
renumbered, or its name will be deleted. 
This method has no effect on any existing 





Since you may not have more than one 
physical page defined for an environment, 
the add selection will ONLY be allowed for 
the physical page IF it is not defined in the 
current environment. 


Fill 


This selection would be used if you wish to 
copy all specifications in the specified file 
which do not exist in the current 
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environment, for the parts selected in the 
Parts to Copy field. 


Figure 3-18 shows the results of each of the above 
selections. The final environment will appear as 
shown in the columns under the function selected. 


4. The Copy Associated Compiled 
Parts? Field 


parts? Y/N 








LPO SOURCE LPO DEST. LPO=0 SOURCE 








LP1 SOURCE LP1 ~---- LP1=1 SOURCE 


LP2=2 SOURCE 





LP2 SOURCE Lp ---- 








LP3 SOURCE LP3 ---- LP3=3 SOURCE 





LP4 DEST. 


IFS/3000 COPY FUNCTIONS 


|__—— DESTINATION AFTER COPY FUNCTION + 
LPO=0 SOURCE |LPO=0 DEST. 
LP1=1 SOURCE }{LP1=0 SOURCE 
LP2=2 SOURCE {LP2=1 SOURCE 
LP3=3 SOURCE |LP3=2 SOURCE 


LP4=4 DEST. 


IFS looks to see if location is filled, it DOES NOT KNOW what is there. 


The default for this field is N (=no). You can 
specify that you want to copy the compiled part 
along with its specifications by changing N (=no) to 






you specify in the Method of Copy field has the 
same effect on the existing compiled parts as it 
does on the existing specifications. 














LPO=0 DEST. 









LP1=1 SOURCE 






LP2=2 SOURCE 









LP 3=3 SOURCE 






tP4=4 DEST. LP4=4 DEST. 








LPS=3 SOURCE 





Figure 3-18. Copy Field Selection Results 


Jan 84 
3-80 





Overview 


The LPS Interpreter, included with the Printer 
Graphics Package (HP 36583) provides a 
non-programmatic interface to the IFS/3000 
intrinsics and gives you access to the features of 
the Laser Printer via commands embedded in text 
files. 


Text files consist of text to be printed and 
formatting commands. These commands allow you 
to control such things as the character font or 
form being printed, or the location and direction of 


of the text. You can also print data into a form 
using named fields and, if you have the HP 
graphics software, you can merge graphics output 
with your text at print time. 


The LPS Interpreter sends environment files and 
text files to the Laser Printer and executes 
formatting commands by calling the IFS/3000 
programmatic intrinsics. It is not necessary to 


‘have knowledge of a programming language to use 


the LPS Interpreter. 


Figure 4-1 provides an illustration of the LPS 
Interpreter in the HP 3000 environment. 
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Figure 4-1. Overview of the LPS Interpreter 
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Intrinsic Calls 


The LPS Interpreter automatically calls the MPE 
FOPEN intrinsic and the IFS/3000 PINITDEVICE 
and PERRMSG intrinsics. Also, in contrast to the 
programmatic intrinsics, it is not necessary to 
supply a comarea parameter with any of the 
commands or a datalen parameter with the 
-WRITEFIELD command. Data length is 
determined by the length of the text itself. 


With the release of LPS version A.01.07, there is 
no longer a fixed limit on the environment size 
which may be run with LPS. However, if you use 
the LPS commands . CONVERTRASTER, 
-CONVERTFIGURE, or .PRINTFIGURE, you should 
have an environment with a comarea length less 
than 3000 words. Otherwise there may not be 
enough system stack area to manipulate the desired 
image. The Interpreter issues a warning to this 
effect if a larger environment file is specified (see 
“Running the LPS Interpreter", later in this 
section). 


Section 5 of this manual describes the IFS/3000 
programmatic intrinsics. 


Text Files 


Your text file can be an ASCII file created with 
any HP 3000 text editing subsystem. All LPS 
Interpreter commands are used in the same way, 
regardless of the text editor you choose. 


LPS INTERPRETER 


Text files must be kept unnumbered for use 
with the LPS Interpreter. For information 
on creating a text file, refer to the 
Reference Manual for the text editor you 
are using. 


LPS Interpreter text files consist of text to be 
printed, formatting commands, and _ control 
characters which are used to distinguish commands 
from the text to be printed. 


Text 


Text 1s whatever you want to appear in your 
printed document. Anything that is not preceded 
by a control character is recognized as text to be 
printed. Text can also be printed to a named field 
on a form with the .WRITEFIELD command. 


Commands 


Formatting commands are used to give the Laser 
Printer directions on how you want your document 
printed. All commands are preceded by a 
command control character and most are followed 
by one or more parameters. The default control 
character is a period (.) 
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If there is more than one parameter, they should be 
separated by: . 


® one or more spaces, or 
e acomma with no spaces, or 
e acomma and one or more spaces. 


For example: 


.COMMAND parameterl parameter2 
.COMMAND parameter1,parameter2 
.COMMAND parameterl, parameter 2 


Descriptions of all commands appear later in this 
section. To change the default command control 
character, refer to the description of the 
. CONTROLCHAR command. 


Continuation Lines 


You can continue a command on to the next line 
by putting a continuation character at the end of 
the first line of the command. The continuation 
character must be preceded by a blank and must be 
the last character on the line. The default 
continuation character is an ampersand (&). For 
example: 


.COMMAND parameterl parametere2 & 
parameter3 parameter4 parameters 


To change the default continuation character, 
refer to the description of the .CONTINUECHAR 
command. 
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Comments 


A comment character is placed before each 

comment line. Comments serve as notes and 

comments to you when you are creating or 

reviewing a text file. The default comment 

character is an exclamation point (t). For example: 
This is a comment line 


To change the default comment character, refer to 
the description of the .COMMENTCHAR command. 


Default Parameters 


You can use an asterisk (*) in place of a command 
parameter to select the default. For example: 


.COMMAND parameterl * * parameter4 


To change the default character, refer to the 
description of the .DEFAULTCHAR command. 


Supplied defaults are: 


. COMMENTCHAR : 

. CONTINUECHAR & 

. CONTROLCHAR . 

. DEFAULTCHAR * 

. SHIFTCHAR | 

figure rotation 0 degrees 
raster image type O (temporary) 
position mode 0 (relative) 
units 0 (dots) 
xposition 0 

yposition 0 

subfield number Only subfield 
carriage control NOCCTL 


Shift Character 


A shift character is used to change from primary 
to secondary character font, or vice versa. The 
default shift character is a vertical bar (|). For 
example: 


This line |will print intwo| typefaces 


To change the default shift character, refer to the 
description of the .SHIFTCHAR command. 


Output File 


The formal file designator for the LPS Interpreter 
output spool file is LPSOUT. The Laser Printer is 
automatically used as the output device (device 
class PP or PP88) unless you specify otherwise. To 
do this, you must set up a file equation to direct 
the file LPSOUT to another device or device class. 
For example: 


:FILE LPSOUT;DEV=device;ENV=envfile 


The device class can be specified by device class 
name or logical device number. 


LPS INTERPRETER 


If you wish to direct your output to a device class 
other than PP (2680A) or PP88 (2688A), you must 
set up this file equation prior to running the LPS 
Interpreter. 


Be sure to specify your environment file name in 
the file equation. When the LPSOUT file is 
redirected, the environment file name you give to 
the LPS Interpreter & : 

is ignored. 





Carriage Control 


Carriage control in a data file is recognized by 
using the INCLUDE command with the CCTL 
parameter. 
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Running the LPS Interpreter 


After you have successfully logged on and received the MPE colon prompt (:), type the command: 
:RUN LPS.PUB.SYS 
and press (RETURN). 


The first message you see will display the version of the LPS Interpreter available on your system followed by 
the version of the IFS Intrinsics as follows: 


LPS Interpreter (A.01.07) HP36580 (c) COPYRIGHT Hewlett-Packard Co. 1982 
IFS/3000 Intrinsics (A.02.03) 


The LPS Interpreter will then prompt for the following information or exit instructions: 
What device are you printing to (2680A or 2688A)? 
Environment file (or ’Exit’ to leave)? 
Environment size is XXXXX words. 
Your output is being spooled to *LPSOUT’. 
If your environment size is greater than 3000 words, the LPS Interpreter will display: 
WARNING: Your environment file has a length greater than 3000 words. If you use 
the LPS commands .convertraster, .convertfigure, or .printfigure the program may 
abort if there is not enough area left on the system stack to manipulate the 


desired image. 


If your environment size is 3000 words or less, this warning will not be issued. In either case, the LPS 
Interpreter continues as follows (giving you the option to exit): 


Interactive (Y/N/Exit)? 
For help type *.help’. 
> 


Sept 84 
4-6 


Capabilities 


Users of some commands in the LPS Interpreter 
will need to have DS (extra Data Segments) 
capability. Check with your system manager if 
you have any questions about your user 
capabilities. 


Output Device 


Type the name of th 
print to at the 





t device you wish to 


P (e.g., 2680A or 









yin 


If you press without specifying an output 
device, the request will be repeated until you 
specify a device. 


Environment File 


The LPS Interpreter sends your text file and 
environment file to the Laser Printer to print your 
formatted document. If you do not want to use 
one of the environments supplied with IFS/3000, 
you must create your own environment file before 
printing your document. 


Type the name of your environment file beside the 


? prompt and press (RETURN). 





LPS INTERPRETER 


If you press without specifying an 
environment, the Laser Printer will default to the 
standard line printer environment for the output 
device specified at the Output , 





IFS/3000 checks to verify that the filename you 
supply is an existing environment file. If it is, IFS 
displays the file size. If it is not a valid 
environment file, you receive an error message and 
are given the option of exiting or specifying 
another environment file name. 


Sessions 


When your environment filename has been 
accepted, you are asked if you want to work in an 
interactive session. The LPS Interpreter can be 
used in two ways: 


e you may enter formatting commands and text 
interactively. 


e you may supply the name of a formatted text 
file to be printed. 
Interactive 


Type Y beside the 
press (RETURN). 


prompt and 





You have now begun an interactive session and the 
> prompt indicates that you can enter the text and 
formatting commands for the document you want 
to print. 
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NOTE 


It is important to note that the LPS 
Interpreter is not a text editor. Text is 
spooled to the Laser Printer as each line is 
entered, making it impossible to go back 
and make changes to text lines. You would 
normally work interactively if you wanted 
to create a test file of commands for a 
skeleton document, rather than to build a 
complete document. 


When you have entered all your text and 
formatting commands, type the command: 

EXIT 
This closes the spoolfile making it ready to print 
your document and returns you to the MPE 
Operating System. 
If you want to print another file, you must run the 


LPS Interpreter again. 


Non-interactive 








Type N beside the | 
press (RETURN). 


? prompt and 





You are now asked for the name of your input 
file. Type the name of your formatted text file 
beside the ; 
(RETURN). 
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The message: 
Reading input file ... 


is displayed to tell you that your text file is being 
processed and printed. After your file has been 
processed to the spooler, you are returned to the 
MPE Operating System. 


If you want to print another file, you must run the 
LPS Interpreter again. 


Batch Job 


You can also run the LPS Interpreter by creating a 
stream file to be run asa batch job. If you use this 
method, the commands in your stream file must 
exactly correspond to the LPS Interpreter prompts. 
A sample stream file is given in the examples at 
the end of this section. 


Ending A Session 


When you want to end an LPS Interpreter session, 
type the command: 


EXIT 


Your spoolfile is then closed and is ready for 
printing, even if you exit at a time when no text 
has been entered. You are returned to the MPE 
Operating System and the following message is 
displayed: 

END OF PROGRAM 


Terminology 


Before using the commands described in this 
section, be sure you are familiar with the 
terminology explained in Section 2. 


LPS Interpreter Commands 


The LPS Interpreter commands are divided into 
two groups. Each group requires different software 
subsystem capabilities as follows: 


e LPS Formatting commands can be used if you 
have IFS/3000 installed on your system. 


e Graphics commands are available with the HP 
graphics software. 


Figure 4-2 summarizes the formatting and 
graphics commands. A full description of each 
command is listed alphabetically, following the 
summary. 


The HP non-graphics software includes all LPS 
Interpreter commands. 


LPS INTERPRETER 


Abbreviations 


In the descriptions that follow, all commands may 
be abbreviated as indicated by the square brackets 
[ |; that is, letters that appear in the brackets are 
optional. For example, 


.U[SEFONT ] 
may be specified in any of the following ways: 


. USEFONT 
. USEFON 

. USEFO 

. USEF 
USE 

-US 

~U 
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INTRINSICS | FUNCTION | 


. ACTIVATEPAGE Activates a logical page. 
. COMMENTCHAR Changes the default comment character. 
. CONTINUECHAR Changes the default continuation character. 
. CONTROLCHAR Changes the default control character. 
- CONVERTF IGURE Converts a figure in a figure file to a raster image file. 
- CONVERTRASTER Accepts dot-per-bit raster data graphics. 
The basic image can be manipulated, including 
rotation and scaling, and a formatted raster 
image file is created which is printable 
on the Laser Printer. 


. DEACTIVATE PAGE Deactivates a logical page. 

. DEFAULTCHAR Changes the default parameter character. 

. DELETERASTER Deletes a raster image from Laser Printer memory. 

- ENDWRITEFIELD Stops printing text into a field on a form. 

~ EXIT Leaves the LPS Interpreter and returns you to the 
MPE Operating System. 

. FLASHRASTER Loads a raster image into Laser Printer memory, prints it, 
then deletes it from Laser Printer memory. 

- HELP Provides help on LPS Interpreter commands. 

- INCLUDE Allows you to include text and commands from another 
text file. 

. LOADRASTER Loads a raster image into Laser Printer memory. 

. MOVEPENABS Moves the Laser Printer "pen" relative to the upper 
left corner of the logical page. 





Figure 4-2. LPS Interpreter Commands 
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LPS Interpreter Commands 


INTRINSICS FUNCTION 


.MOVEPENREL Moves the Laser Printer "pen" relative to its current 
position. 

. NEWF ORM Selects the form you want to print to. 

. NEWPAGE Advances to the next active logical page. 

. NEWPHYSPAGE Advances to the next physical page. 

. NEWSUBF ORM Selects the subform you want to print to. 

- PRINTF IGURE Converts a figure in a figure file to a raster image file. 
then loads and prints the raster image and deletes it 
from the printer memory. 

. PRINTRASTER Print a raster image loaded via LOADRASTER command. 

. SELECT PAGE Activates and advances to the selected logical page. 
Optionally performs a physical page eject. 

. SHIFTCHAR Changes the default shift character. 

. USEFONT | Selects primary and secondary character fonts 

-WRITEFIELD Prints text in a field or subfield on a form. 





Figure 4-2. LPS Interpreter Commands (con’t.) 
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-ACTIVATEPAGE 


Activates a logical page. 


Syntax 


-A[CTIVATEPAGE] logical pagenumber 





Parameters 

Logical pagenumber The page number of the logical page you want to activate; must be between 0 
and 31, inclusive, and must correspond to a logical page in the environment you 
are using to print your document. 

Discussion 


The Laser Printer manages logical pages by number and determines which page to print next by cycling 
through the logical page numbers of active pages. If a logical page is not currently active, it is skipped and is 
not printed. .ACTIVATEPAGE is used to make an inactive logical page active so that it will be printed. Once 
activated, the logical page will continue to print until deactivated with the .DEACTIVATEPAGE command. 
There must be at least one active logical page in a job when attempting to print to the printer. 


Example 

Al 
Logical page 1 was defined as initially inactive in the environment file. When you are ready to print the 
page, this command makes it available for printing. If the page was initially active in the environment file it 


would not be necessary to use the .ACTIVATEPAGE command unless the .DEACTIVATEPAGE command had 
been used previously to make it inactive. 
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-COMMENT CHAR 


Changes the default comment character. 


Syntax 


.COM[MENTCHAR] character 





Parameters 

character The character you want to use to indicate a comment line in your text. You 
can use any character except an ampersand (&), a comma (,), a space, or any 
character currently defined as the control or continuation character. 

Discussion 


You can include comment lines in your text file to serve as notes or comments to yourself when you are 
entering text. These comment lines are not printed with your document. Each comment line must be 
preceded by a comment character to distinguish it from text that is to be printed. The default comment 
character is an exclamation point (t). If you do not want this to be your comment character, use the 
. COMMENTCHAR command to change it to the character of your choice. 


Example 


*The next command will change the comment character 
.COM §$ 
$This is a comment 


The comment character is now a dollar sign ($). All comment lines you enter must now be preceded by this 
character. 
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-CONTINUECHAR 


Changes the default continuation character. 


Syntax 


.CONTI[NUECHAR] character 





Parameters 

character The character you want to use to indicate a continuation line in your text file. 
You can use any character except a comma (,), a space, or any character 
currently defined as the control or comment character. 

Discussion 


You can continue a command on to the next line by placing a continuation character at the end of the first 
line of text. This character must be preceded by a blank and must be the last character on the line. The 
default continuation character is an ampersand (&). If you do not want this to be your continuation 
character, use the .CONTINUECHAR command to change it to the character of your choice. 


Example 
.CONTI + 


The continuation character is now a plus sign (+). When you want to continue a command on to the next line, 
the first line of the command must now end with a blank followed by a plus sign. 
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-CONTROLCHAR 


Changes the command control character. 


Syntax 


-CONTR[OLCHAR] character 





Parameters 

character The character you want to use to indicate a command line in your text. You 
can use any character except an ampersand (&), a comma (,), a space, or any 
character currently defined as the comment or continuation character. 

Discussion 


Each formatting command must be preceded by a control character to distinguish it from text to be printed. 
The default control character is a period (.). If you do not want this to be your control character, use the 
. CONTROLCHAR command to change it to the character of your choice. 


Example 


-CONTR 3; 
;ACTIVATE 3 


The control character becomes a semicolon (;). All formatting commands must now be preceded by this 
character. 
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-CONVERTFIGURE 


Converts a figure in a figure file into a partitioned raster image file which is the format required for printing 


by the Laser Printer. 


Syntax 


-CONVERTF [IGURE] figurefilename figurename rasterfilename outputdevice 


imageheight units imagerotation 





Parameters 
figurefilename 
figurename 


rasterfilename 


out putdevice 


tmageheight 


The name of the figure file that contains the figure you want to convert. 
The name of the figure you want to convert. 


The name of the partitioned raster image file that will contain the converted 
figure. 


The name of the output device (2680A or 2688A) that will print the figure. 
This name can be up to six characters long. 


The height of the partitioned raster image viewed in the direction of its 
orientation and given in the units specified in the wnits parameter. The 
width of the partitioned raster image is automatically calculated from the 
height you specify. Refer to Section 2 on Terminology for more information 
on partitioned raster image height and orientation. One dot is added to the 
height you specify when the figure is converted; that is, a specified height of 
300 dots creates a partitioned raster image 301 dots high. You only need to 
take this into account if you are working with extremely precise dot 
measurements. 
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units The unit of measurement used for the partitioned raster image height. Must be 
0, 1, 2, or 3. 
0 = dots 
1 = inches 
2 = centimeters 
3 = millimeters 


You can specify the default unit of measurement (dots) by using the default 
character in place of this parameter. 


tmagerotation The orientation of the printed image with respect to the physical page. Must 
be either 0, 90, 180 or 270. You can specify the default rotation (0 degrees) by 
using the default character in place of this parameter. Refer to Section 2 on 
Terminology for more information on partitioned raster image rotation. 

Discussion 

. CONVERTF [IGURE] enables you to convert a figure in a figure file into a partitioned raster image file. A 

partitioned raster image file is the format required for printing by the Laser Printer. The rasterfilename 

you assign here is also used with the . LOADRASTER or .FLASHRASTER command. 

Example 

-CONVERTF FIGFILE FIG RASTFILE 2680A 6 1 90 


The figure, FIG, which is stored in the file, FIGFILE, is converted for HP 2680A Laser Printer output. The 
converted file is called RASTFILE and is an image 6 inches high, at a 90 degree rotation. 
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-CONVERTRASTER 


Accepts dot-per-bit raster data graphics. The basic image can be manipulated, including rotation and scaling, 
and a formatted partitioned raster image file is created which is printable on the Laser Printer. 


Syntax 


-CONVERTR[ASTER] inrasterfilename outrasterfilename outputdevice 


imageheight imagewidth units imagerotation 


scalingmethod thresholdvalue inverseoption 





Parameters 


tnrasterfilename 


outrasterfilename 


out putdevice 


itmageheight 


imagewidth 


The name of the dot-per-bit raster file that you want to convert. This name 
can be up to 35 characters (upper or lower case) beginning with a letter, and 
cannot include any embedded blanks. 


The name of the partitioned raster image file that will contain the partitioned 
raster image. This array can be up to 35 characters to allow for a fully 
qualified MPE file name. 


The name of the output device for which the figure is to be converted. This 
name can be up to six characters long. 


The height of the partitioned raster image, viewed in the direction of its 
orientation, prior to rotation, and given in the units specified in the first word 
of the units parameter. Refer to Section 2 on Terminology for more 
information on partitioned raster image height and orientation. 


The width of the partitioned raster image, prior to rotation, given in the units 
specified in the first word of the units parameter. 
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untts 


imagerotatton 


scalingmet hod 


Sept 84 
4-20 


Note: Both imageheight and imagewidth are required parameters and the ratio 
aspects must be calculated for each. 


The unit of measurement used for the partitioned raster image height and 
width. Must be 0, 1, 2 or 3. 


0 = dots 

1 = inches 

2 = centimeters 
3 = millimeters 


You can specify the default unit of measurement (dots) by using the default 
character in place of this parameter. 


The orientation of the printed image with respect to the physical page. Must 
be either 0, 90, 180 or 270. You can specify the default rotation (0 degrees) by 
using the default character in place of this parameter. Refer to Section 2 on 
Terminology for more information on partitioned raster image rotation. 


The temporary file, ROTATEFL, is created which can be saved and used 
separately. (ROTATEFL is a dot-per~bit raster file.) 


Number used to specify the scaling method which will be used to scale the 
raster data. For any one of the following integers specified, the temporary file, 
SCALEEL, is created which can be saved and used separately. (SCALEFL is a 
dot-per-bit raster file.) 


O= Threshold testing only. This method uses the input thresholdvalue, 
or calculates a default threshold which serves as a scaled dot comparison 
value. This method has the best general performance and does well at 
scaling line art graphics. 


1= Pattern recognition. This method attempts to duplicate the pattern of 
the source image by repeating the pattern in the scaled image. It 1S 
more CPU intensive but should give better results in scaled patterns and 
text. 


thresholdvalue 


inverseoption 


Discussion 


-CONVERTRASTER 


2= Randomized threshold testing. This method is best used in grey tone 
picture scaling where there are few defined hard lines. This method is 
CPU intensive. The thresholdvalue can be used to generally increase 
or decrease the lightness of the scaled image. 


Number used to specify a threshold between 1 and 255 which is used in the 
scaling routines. If the value is zero the scaling routine will calculate a default 
threshold based on the scaling factor. This value is passed only if 
scalingmethod = 0 or 2. By increasing the threshold the scaled image 
becomes generally lighter. 


Number used to specify inverse image as = 1, or normal (non-inverse) image as = 
0. The temporary file, INVERSFL, is created and can be saved and used 
separately. (INVERSFL is a dot-per-bit raster file. ) 


~CONVERTR[ASTER] accepts a dot-per-bit raster file. The basic image can be manipulated, including 
rotation and scaling, and a partitioned raster image file is created which is printable on the Laser Printer. 
The outrasterfilename you specify here is used later with the .LOADRASTER or .FLASHRASTER 


commands. 


The requirements for the input raster data are: 


1. The existing partitioned raster file must be a permanent disc file with fixed record length, where 
each logical record represents a left to right raster scan line. 


2. The raster data records must be binary with one bit-per-pixel where there is a one-to-one 
correspondence between each bit turned on and each dot of the printed scan line. 


3. Each scan line (record) can be a maximum of 124 words (1980 dots) in length, and there cannot be 
more than 3060 scan lines (records) in total. 


The command performs as many as four separate functions depending on the values assigned in the parameter 
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-CONVERTRASTER 


list. Each function creates a separate temporary file of raster data which can be saved and used separately. 
These temporary files are created only if the related function is requested through the parameter list. 


Efficiency is increased by determining which function will create a basic temporary file suitable for multiple 


format manipulation without repeating the basic function. As an example, scaling a basic image before 
multiple rotations of the image could be more efficient than rescaling multiple rotations. 


Example 


.CONVERTR EXTERNFL NEWFL 2680A 4.5 3.75 1 0 1 128 0 
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DEACTIVATEPAGE 


Deactivates a logical page. 


Syntax 


.DEA[CTIVATEPAGE] Logical pagenumber 





Parameters 

Logical pagenumber The page number of the logical page you want to deactivate; must be between 0 
and 31, inclusive, and must correspond to a logical page in the environment you 
are using to print your document. 

Discussion 


The Laser Printer manages logical pages by number and determines which page to print next by cycling 
through the logical page numbers of active pages. If a logical page is not currently active, it is skipped and is 
not printed. This command is used to make an active logical page inactive so that it is not printed. 


There must be at least one logical page active in a job when attempting to print to the printer. If you try to 
deactivate the only active page, you will receive a warning message. 


Example 
.DEA 0 


Logical page 0 was defined as initially active in the enviroment file. If you no longer want to print to this 
page, this command makes it unavailable for printing. 
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-.DEFAULTCHAR 


Changes the default character used in command parameters. 


Syntax 


.DEF[AULTCHAR] character 





Parameters 

character The character you want to use as the default character. You can use any 
character except an ampersand (&), a comma (,) or a space. 

Discussion 


When entering formatting commands, you can specify a default parameter by using a default character in 
place of the parameter. The default character is an asterisk (*). If you do not want this to be your default 
character, use the .DEFAULTCHAR command to change it to the the character of your choice. Supplied 
defaults are listed in the discussion on Default Parameters earlier in this section. 


Example 


.DEF = 
.CONVERTFIGURE FIGFILE FIG RASTFILE = 540 = = 


The default character becomes an equal sign (=). The three default parameters in the above command are 
now indicated by this character. 
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-DELETERASTER 


Deletes a partitioned raster image from Laser Printer memory. 


Syntax 


.DEL[ETERASTER] imagenumber 





Parameters 

itmagenumber The number of the partitioned raster image to be deleted. Must be between 0 
and 31 inclusive and must be the number of a partitioned raster image that has 
already been loaded with the . LOADRASTER command. 

Discussion 


A partitioned raster image can be deleted from Laser Printer memory only if it has already been loaded with 
the .LOADRASTER command. You would normally use the .DELETERASTER command after you had finished 
printing a raster image with the . PRINTRASTER command. 
Exampie 

~DEL 5 


Raster image number 5, which you have already loaded with the . LOADRASTER command, is deleted from 
Laser Printer memory. 
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-ENDWRITEFIELD 


Stops printing text to a field on a form. 


Syntax 


.EN[DWRITEFIELD] 





Parameters 


NONE 


Discussion 


The .WRITEFIELD command is used to print text to a named field on a form. Text will be printed even if it 
extends beyond the end of the field. The .WRITEFIELD command moves the laser printer "pen" to the baseline 
at the end of the text that has been printed on the field. When you want to stop printing in the field, you 
can leave it with the .ENDWRITEFIELD command. This command is optional in most cases, since the LPS 
Interpreter stops printing to a field as soon as it encounters any other command in your text file. The 
-ENDWRITEFIELD command is required only when there is no other command present to distinguish the end 
of field text from the beginning of text to be printed outside the field. This usually occurs after printing to 
the last field on a form. 
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-ENDWRITEFIELD 


Example 


-WRITEFIELD SUBJECT 1 

Quarterly Report 

.EN 

Attached is the Quarterly Report. 


Prints the line "Quarterly Report" to subfield 1 of the field SUBJECT. Prints the line "Attached is the 
Quarterly Report" outside the field as data on the logical page. The .ENDWRITEFIELD command is required 
since there is no other command present to distinguish this line from the field text. 


-WRITEFIELD NAME * 

Mr. Jim Small 
-WRITEFIELD ADDRESS 1 
3410 Central Expressway 


In this case, there is no need to use the .ENDWRITEFIELD command after printing to the field NAME. The 
second .WRITEFIELD command automatically takes you out of the current field. 
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-EXIT 


Leaves the LPS Interpreter and returns you to the MPE Operating System. 


Syntax 


-EX[IT] 


Parameters 


NONE 


Discussion 


The .EXIT command is used to leave the LPS Interpreter and return you to the MPE Operating System from 
the LPS prompt (>). If you decide to exit before printing a file, you can use the EXIT command without the 
control character (.) after the E ' prompts. Using the 

.EXIT command after the > prompt in an interactive session automatically prints any text you have entered 
before returning you to the MPE Operating System. 





Example 
EX 
You are returned to the MPE Operating System and the following message is displayed: 


END OF PROGRAM 
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.FLASHRASTER 


Loads a partitioned raster image into Laser Printer memory, prints it, then deletes it from Laser Printer 


memory. 


Syntax 


-F[LASHRASTER] rasterfilename xposition yposition units positionmode 





Parameters 


rasterfilename 


xposttion 


yposition 


The name of the partitioned raster image file you created with the 
- CONVERTFIGURE command. 


The x-coordinate of the upper left corner of the partitioned raster image on 
the current logical page. This is measured in the units specified in the units 
parameter and is either relative or absolute as specified in the positionmode 
parameter. With absolute positioning, only positive values can be used. With 
relative positioning, a positive value moves the image to the right; a negative 
value moves it to the left. You can specify the default x-coordinate of 0 by 
using the default character in place of this parameter. 


The y-coordinate of the upper left corner of the partitioned raster image on 
the current logical page. This is measured in the units specified in the units 
parameter and is either relative or absolute as specified in the positionmode 
parameter. With absolute positioning, only positive values can be used. With 
relative positioning, a positive value moves the image down; a negative value 
moves it up. You can specify the default y-coordinate of O by using the 
default character in place of this parameter. 


For more information on positioning, refer to Section 2 on Terminology. 
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-FLASHRASTER 


units 


positionmode 


Discussion 


The unit of measurement for the x and y-position parameters must be 0, 1, 2 
or 3. 


0 = Dots 

1 = Inches 

2 = Centimeters 
3 = Millimeters 


You can specify the default unit of measurement (dots) by using the default 
character in place of this parameter. 


Number used to specify whether the x2 and y-positions are relative or 
absolute. The relative option positions the partitioned raster image relative to 
the current pen location on the logical page; the absolute option positions the 
image at the absolute location on the logical page. Must be OQ or 1. 


0 
1 


Relative 
Absolute 


You can specify the default position mode (relative) by using the default 
character in place of this parameter. 


-FLASHRASTER combines the effects of . LOADRASTER, .PRINTRASTER and .DELETERASTER to load, print 
and delete a partitioned raster image. Since .FLASHRASTER uses temporary partitioned raster images, and 
each image is referenced only once in a job, this command makes it possible to print up to 64 images on a 
physical page. Remember, however, that 64 is an absolute maximum and the actual number is affected by 


the size of the raster images. 


By allowing you to specify the exact location of the partitioned raster image, this command gives you 
complete control over its placement on the logical page. The image can be positioned relative to the current 
location of the pen, or at an absolute location on the logical page. 


Jan 84 
4-30 


-FLASHRASTER 


The values of the x- and y-coordinates depend on the size of the current logical page. For absolute 
positioning, only positive values can be used. The value for x moves the image to the right, the value for y 
moves it down. For relative positioning, negative values can be used to move the partitioned raster image left 
and up, for x and y respectively. 


x- and ypostttions are checked to ensure that they lie within the boundaries of the logical page, but does 
not check to verify that the entire image fits on the physical page. 


The position of the Laser Printer "pen" is unaffected by printing a partitioned raster image. This means that 
the pen remains where it was prior to printing the image and does not move to a new location. You may have 
to use the .MOVEPENABS or .MOVEPENREL command before you continue printing text. 
Example 

-F RASTFILE 100 -50 * * 
Loads the partitioned raster image in the file RASTFILE into Laser Printer memory, then prints the image 


100 dots right and 50 dots up from the current location of the pen on the logical page. The image is then 
deleted from Laser Printer memory. 
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-HELP 


Provides help on any LPS Interpreter command. 


Syntax 


.H[LELP] command 


Parameters 


command The LPS Interpreter command for which you want help. 


Discussion 


When you are running the LPS Interpreter, you can request help with any of the commands. A description of 
the command, its parameters, and an example of its use will be displayed on the terminal. 
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-HELP 


Example 
-H ACTIVATEPAGE 

Displays information on the .ACTIVATEPAGE command. 
HA 


Also displays information on the .ACTIVATEPAGE command; note that the abbreviated form of commands 
can be used. 


-H 
Lists commands for which help is available. 
.H * 


Displays information on all commands. 
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INCLUDE 


Allows you to include text and commands from another text file. 


Syntax 


.I[NCLUDE] filename carriagecontrol 





Parameters 

filename The name of the formatted text file you want to include in the file you are 
currently using. 

earriagecontrol You may choose whether or not carriage control should be recognized in the 
file you are including. You can specify CCTL for carriage control, or NOCCTL 
for no carriage control. Using the default character in this parameter has the 
same effect as specifying NOCCTL. 

Discussion 


The . INCLUDE command tells the LPS Interpreter to change to another text file and print the text and 
execute the commands that it contains. The included file is processed in its entirety unless an ~EXIT or 
another . INCLUDE command is encountered in the included file. You can have up to 15 levels of embedded 
. INCLUDE commands. 
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INCLUDE 


Example 


Attached is the sales report for the Western Region. 
!Sales report is stored in WESTFILE 

.I WESTFILE * 

‘Sales report has been included here 


The file WESTFILE is included and printed in the file you are currently using. Carriage control is not 
recognized in the included file. 
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-LOADRASTER 


Loads a partitioned raster image into Laser Printer memory. 


Syntax 


.L[OADRASTER] rasterfilename imagenumber 





Parameters 

rasterfilename The name of the partitioned raster image file you created with the 
.CONVERTFIGURE command. 

imagenumber An identification number which you supply for the partitioned raster image. 
Must be between O and 31 inclusive. This number is used later with the 
. PRINTRASTER or . DELETERASTER command. 

Discussion 


A maximum of 32 permanent partitioned raster images can be loaded into Laser Printer memory. This 
maximum is affected by the size of each image. Large images occupy more of the printer memory and the 
number 32 is the absolute maximum. 


If you use the . LOADRASTER command a second time and supply the same partitioned raster image number 
without having deleted the image, the previously loaded image is changed from permanent to temporary. 
This means that it is deleted after it has been printed. All future references to this partitioned raster image 
number will refer to the newly loaded image. 
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-LOADRASTER 


Example 
.L RASTFILE 5 


The partitioned raster image in the file RASTFILE is assigned number 5 and is loaded into Laser Printer 
memory. 
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-MOVEPENABS 


Moves the Laser Printer "pen" relative to the upper left corner of the current logical page. 


Syntax 


.MOVEPENA[BS] sxposition yposittion 





Parameters 

xpositton The number of dots that the pen should be moved to the right of the upper left 
corner of the logical page; must be greater than or equal to zero and must be 
within the boundaries of the logical page. 

yposttton The number of dots that the pen should be moved down from the upper left 
corner of the logical page; must be greater than or equal to zero and must be 
within the boundaries of the logical page. 

Discussion 


It is helpful to imagine that the Laser Printer writes with a "pen" The pen starts writing a characters at its 
cell baseline and left edge. To determine where you want to move the pen, be sure to view the logical page in 
the direction of its orientation. The number of dots expressed in the x position parameter moves the pen to 
the right; the y position parameter moves it down. 


You would use this command when you want the most exact placement of text on the logical page. If you try 
to move the pen outside the boundaries of the logical page, you will receive an error message. 
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-MOVEPENABS 


Example 
-MOVEPENA 25 40 


The leftmost dot of the cell on the baseline begins printing 25 dots to the right and 40 dots down from the 
upper left hand corner of the current logical page. 
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-MOVEPENREL 


Moves the Laser Printer "pen" relative to its current position on the current logical page. 


Syniax 


-MOVEPENR[EL] xposition yposition 





Parameters 

xpositton The number of dots you want to move the pen to the right of its current 
position on the logical page; a negative number moves the pen to the left. The 
pen must remain within the boundaries of the logical page. 

yposttion The number of dots you want to move the pen down from its current position 
on the logical page; a negative number moves the pen up. the pen must remain 
within the boundaries of the logical page. 

Discussion 


It is helpful to imagine that the Laser Printer writes with a "pen". The pen starts writing a character at its 
cell baseline and left edge. To determine where you want to move the pen, be sure to view the logical page in 
the direction of its orientation. The number of dots expressed in the x position parameter moves the pen to 
the right of its current position; the y position parameter moves it down. Negative values move the pen to 
the left or up, for x position and y position respectively. 


You would use this command when you want the most exact placement of text on the logical page. 
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-MOVEPENREL 


Exampie 
-MOVEPENR -25 30 


The leftmost dot of the cell on the baseline begins printing 25 dots to the left and 30 dots down from the 
current position of the pen on the current logical page. After a character is printed the pen remains on the 
baseline of the cell. If the character is proportional the pen is on the right bound of the character just printed, 
otherwise on the right-hand edge of the cell. 
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-NEWFORM 


Selects the form you want to print. 


Syntax 


.NEWF [ORM] formname 





Parameters 

formname The name of the form you want to print to; must be on the current logical 
page. 

Discussion 


If there is only one form on the logical page, it is automatically selected as the current form. Use the 
.NEWFORM command to select the form you want to write to only when there is more than one form on the 
current logical page. It is used to select the particular form you want to write to. You can also use the 
values "1" and "2" instead of using the form name. These are forms 1 and 2 as specified on the LOGICAL 
PAGE FORMS Menu in IFS/3000. 


Example 
.NEWF MEMO 


The form MEMO is selected as the form on the current logical page that you want to print to. The 
.WRITEFIELD command is used to print the actual text. 
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-NEWPAGE 


Advances to the next active logical page. 


Syntax 


.NEWPA[GE] 


Parameters 


NONE 


Discussion 


This command is used to go to the next active logical page. If you are already on the last logical page, it 
causes a physical page eject and takes you back to the first active logical page. 


.NEWPAGE automatically makes the first form on the first active logical page the current form. This 


eliminates the need to use .NEWFORM since the first active form is the one you normally want to print to. 
. NEWPAGE causes any forms on the current iogical page to be printed before advancing to the next page. 


Example 
.NEWPA 


The next active logical page is used for printing. 
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-NEWPHYSPAGE 


Advances to the next physical page. 


Syntax 


. NEWPH [ YSPAGE ] 





Parameters 


NONE 
Discussion 


.NEWPHYSPAGE advances to the next physical page and begins printing with the first active logical page, 
including any forms associated with it. .NEWPHYSPAGE determines the current form using the same method 
as .NEWPAGE. 


Example 
» NEWPH 


The Laser Printer does a physical page eject and begins printing with the first active logical page. 
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-_NEWSUE 





3FORM 


Selects the current subform to which you want to print. 


Syntax 


NEWS [UBFORM] subformname 





Parameters 


subformname The name of the current subform to which you want to print. 


Discussion 

. NEWSUBFORM is used only when there are multiple subforms within a form. .NEWSUBFORM is required when 
you are printing to a form containing duplicate field names. If all the fields have different names, this 
command is optional. 


Exampie 


-NEWS ADDRESS 
-WRITEFIELD NAME * 


The form you are printing to has more than one field called NAME. This command specifies that you want 
to print to the NAME field on the subform ADDRESS, as opposed to the NAME field on any other subform. 
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-PRINTFIGURE 


Converts a figure in a figure file to a partitioned raster image file, then prints the partitioned raster image. 


Syntax 


.PRINTF[IGURE] figurefilename figurename rasterfilename imageheight 


units imagerotation xposition yposition posittonmode 


rasterimagetype 





Parameters 
figurefilename 
figurename 


rasterfilename 


tmagehetght 
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The name of figure file that contains the figure you want to convert. 
The name of the figure that you want to convert. 


The name of the partitioned raster image file that will contain the converted 
figure. This parameter is optional; if it is not used, you must use the default 
character in this position. See the Discussion for more information on 
supplying the partitioned raster file name. 


The height of the partitioned raster image, viewed in the direction of its 
orientation, and given in the units specified in the units parameter. The 
width of the partitioned raster image is automatically calculated from the 
height you supply in this parameter. Refer to Section 2 on Terminology for 
more information on partitioned raster image height and orientation. One dot 
is added to the height you specify when the figure is converted; that is, a 
specified height of 300 dots creates a partitioned raster image 301 dots high. 
You only need to take this into account if you are working with extremely 
precise dot measurements. 


units 


imagerotation 


xposition 


yposition 


positionmode 


-PRINTFIGURE 


The unit of measurement to be used for the tmageheight and x and 
yposttion parameters. Must be 0, 1, 2 or 3. 


0 = Dots 

1 = Inches 

2 = Centimeters 
3 = Millimeters 


You can specify the default unit of measurement (dots) by using the default 
character in place of this parameter. 


The orientation for the printed image with respect to the logical page. Must be 
either 0, 90, 180 or 270 degrees. You can specify the default rotation (0 
degrees) by using the default character in place of this parameter. For more 
information, refer to Section 2 on Terminology. Also refer to Figure 4-3 in 
the Examples of this command. 


The x-coordinate of the upper left corner of the partitioned raster image on 
the current logical page. The coordinate is measured in the units specified in 
the units parameter and is either relative or absolute as specified in the 
posittonmode parameter. With absolute positioning, only positive values can 
be used. With relative positioning, a positive value moves the image to the 
right; a negative value moves it to the left. You can specify the default x 
coordinate of 0 by using the default character in place of this parameter. 


The y-coordinate of the upper left corner of the partitioned raster image on 
the current logical page. The coordinate is measured in the units specified in 
the units parameter and is either relative or absolute as specified in the 
posittonmode parameter. With absolute positioning, only positive values can 
be used. With relative positioning, a positive value moves the image down; a 
negative value moves it up. You can specify the default y coordinate of 0 by 
using the default character in place of this parameter. 


Number used to specify whether the x- and ypositions are relative or 
absolute. The relative option positions the partitioned raster image relative to 
the current pen location on the logical page; the absolute option positions the 
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-PRINTFIGURE 


image at the absolute location on the logical page. Must be 0 or 1. 


0 
1 


Relative 
Absolute 


You can specify the default position mode (relative) by using the default 
character in place of this parameter. 


rasterimagetype Specifies whether the partitioned raster image is permanent or temporary. 
Must be 0 or 1. 


0 
1 


Temporary 
Permanent 


A temporary image is deleted from Laser Printer memory immediately after it 
has been printed. A permament image remains in memory for future use. 


You can specify the default partitioned raster image type (temporary) by using 
the default character in place of this parameter. 


Discussion 


. PRINTFIGURE allows you to specify the figure to be printed in one of two ways: either with or without the 
rasterfilename as a parameter. If you use the partitioned raster file name, the partitioned raster image 
can be printed directly. .PRINTFIGURE compares the rotation, size and creation date of the partitioned 
raster image with those of the figure in the figure file. If the rotation or size do not match or if the figure 
date 1s more recent than the partitioned raster image date, a new partitioned raster image file is created. This 
new partitioned raster image file replaces the file you specified and is given the same name. Specifying an 
existing partitioned raster file name can save time and system resources since there is no need to reconvert a 
figure that has not been changed. 


If you do not specify a partitioned raster file name, .PRINTFIGURE converts the figure in the figure file to a 
partitioned raster image and places it in a temporary MPE file named OUT2680A or OUT2688A. 
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-PRINTFIGURE 


.PRINTFIGURE also deletes permanent partitioned raster images from Laser Printer memory on a 
least-recently used basis when it is necessary to make room for another permanent partitioned raster image. 
When an image has been deleted from memory, it has to be reloaded if needed again. 


The position of the Laser Printer "pen" is unaffected by printing a figure. This means that the pen remains 
where it was prior to printing the figure and does not move to a new location. You may have to use the 
.MOVEPENABS or .MOVEPENREL command before you continue printing text. 


Example 
.PRINTF FIGFILE FIG RASTFILE 5 1903211 


Prints the figure FIG which is stored in the file FIGFILE and has been converted to the file RASTFILE. It is 
5 inches high and is printed at 90 degree orientation, 3 inches to the right and 2 inches down from the top 
left corner of the logical page. The partitioned raster image is specified as permanent and remains in Laser 
Printer memory after printing. 


.PRINTF DRAWFILE DRAW * 360 * * -180 180 * * 


The figure DRAW which is stored in the file DRAWFILE is converted to a partitioned raster image and 
printed. It is 361 dots high and is printed at 0 degree orientation, 180 dots to the left and 180 dots down 
from the current location of the pen on the logical page. The image is specified as temporary and is deleted 
from Laser Printer memory after printing. 


Figure 4-3 shows figures printed at 0 and 90 degree rotations on different logical page orientations with the 
.PRINTFIGURE command. The logical page dimensions are 10x 7 inches, and the figure is 5 inches high. 
The rotation of the figure is specified with respect to the logical page. 
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-PRINTFIGURE 
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Figure 4-3. Figures printed with the . PRINTFIGURE command 
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-PRINTRASTER 


Prints a partitioned raster image which has been loaded into Laser Printer memory. 


Syntax 


.PRINTR[ASTER] imagenumber xposition yposition units positionmode 





Parameters 


tmagenumber 


xposition 


yposition 


units 


The number of the image to be printed, as specified in the .LOADRASTER 
command. Must be between 0 and 31 inclusive. 


The x-coordinate of the upper left corner of the partitioned raster image on 
the current logical page. This is measured in the units specified in the units 
parameter and is either relative or absolute as specified in the posttionmode 
parameter. With absolute positioning, only positive values can be used. With 
relative positioning, a positive value moves the image to the right; a negative 
value moves it to the left. You can specify the default x-coordinate of 0 by 
using the default character in place of this parameter. 


The y-coordinate of the upper left corner of the partitioned raster image on 
the current logical page. This is measured in the units specified in the units 
parameter and is either relative or absolute as specified in the positionmode 
parameter. With absolute positioning, only positive values can be used. With 
relative positioning, a positive value moves the image down; a negative value 
moves it up. You can specify the default y-coordinate of O by using the 
default character in place of this parameter. 


For more information on positioning, refer to Section 2 on Terminology and to 
Figure 4-4 in the Examples of this command. 


The unit of measurement for the x and y-position parameters. Must be 0, 1, 2 
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-PRINTRASTER 


positionmode 


Discussion 


or 3. 
0 = Dots 
l = Inches 
2 = Centimeters 
3 = Millimeters 


You can specify the default unit of measurement (dots) by using the default 
character in place of this parameter. 


Number used to specify whether the x- and ypositions are relative or 
absolute. The relative option positions the partitioned raster image relative to 
the current pen location on the logical page; the absolute option positions the 
image at the absolute location on the logical page. Must be 0 or 1. 


0 = Relative 
1 Absolute 


You can specify the default position mode (relative) by using the default 
character in place of this parameter. 


-PRINTRASTER prints a partitioned raster image on the Laser Printer. The image must already have been 
loaded into Laser Printer memory with the . LOADRASTER command. 


By allowing you to specify the exact location of the partitioned raster image, this command gives you 
complete control over its placement on the logical page. The image can be positioned relative to the current 
location of the pen, or at an absolute location on the logical page. 


The values of the x and y-coordinates depend on the size of the current logical page. For absolute 
positioning, only positive values can be used. The value for x moves the image to the right, the value for y 
moves it down. For relative positioning, negative values can be used to move the image left and up, for x and 
y respectively. x and ypositions are checked to insure that they lie within the boundaries of the logical 
page, but does not check to verify that the entire image fits on the physical page. 
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-PRINTRASTER 


The position of the Laser Printer "pen" is unaffected by printing a partitioned raster image. This means that 
the pen remains where it was prior to printing the image and does not move to a new location. You may have 
to use the .MOVEPENABS or .MOVEPENREL command before you continue printing text. 


Example 
.PRINTR 4 * * * 1 

Raster image number 4 is printed in the absolute top left corner of the logical page. 
.PRINTR 1 2 -6 1 * 


Raster image number 1 is printed with its upper left corner 2 inches to the right and 6 inches up from the 
current location of the pen on the logical page. Figure 4-4 shows partitioned raster images at Oand 90 
degree rotations printed on different logical page orientations with the .PRINTRASTER command. The 
logical page dimensions are 10x 7 inches and the partitioned raster image is 5 inches high. The rotation of 
the image was assigned with the .CONVERTFIGURE command and is specified with respect to the physical 
page. 
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-PRINTRASTER 
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Figure 4-4. Raster images printed with the . PRINTRASTER command 
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-SELECTPAGE 


Activates and advances to the selected logical page. Optionally performs a physical page eject. 


Syntax 


-SE[LECTPAGE] Logicalpagenumber ejectoption 





Parameters 

Logical pagenumber Number of the logical page to be activated. 

ejectoption Optional specification of PHYS for physical page eject; or, NOPHYS for no 
physical page eject. Using the default character in this parameter has the same 
effect as specifying NOPHYS. 

Discussion 


The Laser Printer manages logical pages by number and determines which page to print next by cycling 
through the logical page numbers of active logical pages. .SELECTPAGE enables you to activate any logical 
page in the environment, in any order, so that it will be printed once. The logical page selected remains 
activated and will then print in numerical order as the Laser Printer continues cycling through the active 
logical pages. 
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.SELECTPAGE 


Exampie 
.SE 2 NOPHYS 
.SE 0 PHYS 


.SE 14 * 
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(Advances to logical page 2, no eject) 
(Advances to logical page 0, with eject) 


(Advances to logical page 14, no eject) 


.OHIF TCHAR 


Changes the shift character used to change between primary and secondary character fonts. 


Syntax 


.SH[LIFTCHAR] character 





Parameters 

character The character you want to use as the shift character. You can use any 
character except an ampersand (&), a comma (,), a space, or any character 
currently defined as the comment, control, or continuation character. 

Discussion 


The .SHIFTCHAR is used to change to the alternate character font within a text file; that is, to the secondary 
font if primary is currently being used, or to primary if secondary is being used. The default shift character 
is a vertical bar (|). If you do not want this to be your shift character, use the .SHIFTCHAR command to 
change it to the character of your choice. 


Example 
-SH * 
This line of text includes * an italic character font ~ which was defined as the secondary font. 


The shift character becomes ~. The words "an italic character font" are printed in the alternate font. 
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-USEFONT 


Selects primary and secondary character fonts. 


Syntax 


.U[SEFONT] primaryfont secondaryfont 





Parameters 


primaryfont The number of the character font you want to use as the primary font; must be 
between Oand 31 inclusive and must correspond to a character font in the 
environment you are using to print your document. You can specify the 
current primary font by using the default character in place of this parameter. 


secondaryfont The number of the character font you want to use as the secondary font; must 
be between O and 31 inclusive and must correspond to a character font in the 
environment you are using to print your document. You can specify the 
current secondary font by using the default character in place of this 
parameter. 


Discussion 


The primary and secondary character fonts become the fonts with the numbers specified. If the default 
character is used, the font remains unchanged. The shift character (|) is used to change fonts within text. 
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-USEFONT 


Example 
U* 3 


The character font the printer is using to print (primary character font) remains unchanged and the alternate 
(secondary character font) becomes character font number 3. 


U02 


The primary and secondary character fonts are now 0 and 2, respectively. 
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-WRITEFIELD 


Prints text in a field or subfield in a form. 


Syntax 


.W[RITEFIELD] fzeldname subfieldnumber 





Parameters 

fieldname The name of the field you want to print to. 

subfieidnumber The number of the subfield within the field you want to print to. If the field 
has only one subfield, use the default character for this parameter. 

Discussion 


.WRITEFIELD enables you to print text in a field or subfield. Data is centered vertically and left justified 
horizontally in the field or subfield. Text will be printed even if it extends beyond the end of the field. The 
.WRITEFIELD command moves the Laser Printer "pen" to the baseline at the end of the text that has been 
printed in the field. You may have to use the .MOVEPENABS, .MOVEPENREL, or .ENDWRITEFIELD command 
to reposition the pen before you continue printing. 
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-WRITEFIELD 


Example 


.W HEADING 2 
Section 4 


Prints the text "Section 4" into subfield 2 of the field HEADING. 


.W MEMO * 
Distribution 


Prints the text "Distribution" into the only subfield of the field MEMO. 
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Example 1: Environment File 


The environment file used to print the document in figure 4-5 is defined as follows: 


Output Device 
2680A 


Character Font 0 
ROM.CHARSETS.SYS 
10 point 
Portrait orientation 


Character Font 1 
ROMITAL.CHARSETS.SYS 
10 point 
Portrait orientation 


Logical Page 0 

Portrait orientation 
7.0 inches wide 

4.25 inches high 

0.625 inches from left 
1 form with 4 fields, 

each with 1 subfield 

Initially active 


Logical Page l 
Portrait orientation 
7.0 inches wide 
4.25 inches high 
0.625 inches form top 
0.5 inches from left 
No forms 
Not initially active 
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LPS EXAMPLES 


Example 1: Text File 


WOON Mo bPWN FE 


22 


.W FROM * 
Marketing Manager 
WTO * 

Product Managers 
.W DATE * 

July 1, 1982 

.W SUBJECT * 


Quarterly Report 
.MOVEPENA * 540 
Attached is the Quarterly Report for our divisions’s Marketing Department. 


Please review this and return any comments to me by the end of the week. 


.U * 1 

There will be a meeting to discuss |Second Quarter Objectives| in the Board 
Room on |Wednesday, July 7 at 3:00 p.m. | 

!Page 1 ends here 

Al 

.DEA 0 

.NEWPH 

tReport will go on this page 

.IN RPTFILE * 


A detailed explanation of the commands used in this text file is given on the next page. 
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LPS EXAMPLES 


| LINE | COMMAND AND 
NO. PARAMETERS 


1 | .W[RITEFIELD] 
| FROM 
i & 
9 .MOVEPENA[BS] 
*& 
540 
14 | .U[SEFONT] 
* 
1 
15-16; | 
17 ‘ 
18 | .A[CTIVATEPAGE] 
1 
Jan 84 
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DESCRIPTION 


Prints text in a named field on a form. 
The field name. 
Specifies that the field has only one subfield. 


Moves the LASER PRINTER pen relative to the absolute 
top left corner of the logical page; this positions 
the pen to begin printing the text of the memo. 
Moves the pen 0 dots to the left which is the 
default (*) position. 

Moves the pen 540 dots (1 inches) down. 


Specifies which character fonts are to be used as 
primary and secondary fonts. 

The primary font becomes the font currently being 

used for printing. 

The secondary font becomes character font number 1 

from the environment file, in this case, Roman Italics. 


Shift character used to change between primary and 
secondary fonts when the documentis printed 


This line is a comment line. 


Activates a logical page that is currently inactive 
which is now required for printing. 

Logical page number to be activated. In this case, 
this is the logical page without forms to be used for 
the second physical page of the document. 





L 


INE 
NO. 


COMMAND AND 
PARAMETERS 


. DEA[CTIVATEPAGE ] 


0 


. NEWPH [YSPAGE ] 


~I[NCLUDE] 
RPTFILE 
# 


LPS EXAMPLES 


DESCRIPTION 


Deactivates a logical page that is currently active 
which is no longer required for printing. 

Logical page number to be deactivated. In this case, 
this is the logical page with the form which was used 
for the first physical page of the document. 


Ejects to the next physical page. 


Includes and prints another text file at this point. 
The name of the file to be included. 

Specifies no carriage control (default) on the 
included file. 





Jan 84 
4-65 


LPS EXAMPLES 
Example 1: Output 


The printed output of this file is shown below. The second physical page of this document would be the file 
that was included in the last line of the text file. 


FROM: Marketing Manager DATE: July 1, 1982 


TO: Product Managers SUBJECT: Quarterly Report 


Attached is the Quarterly Report for our division’s Marketing Department. 


Please review this and return any comments to me by the end of this week. 


There will be a meeting to discuss Second Quarter Objectives in the 
Board Room on Wednesday, July 7 at 3:00 p.m. 





Figure 4-5. Example 1 Output 
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LPS EXAMPLES 


Example 2: Environment File 


The environment file used to print this document is the supplied environment LP.HPENV.SYS. 


Example 2: Text File 


WOanwn ed orp WM Fe 


The following figure is 1.5 inches high and is printed at 0 
degree rotation with respect to the physical page. 
.CONVERTF FIGFILE PRINTER RAST1 2680A 1.5 1 * 

.LOAD RAST1 1 

-PRINTR 12.711 

.MOVEPENA * 495 

The same figure has been moved to the right so that this text 
can be printed to the left of it. 

-PRINTR 1 4.5 2.5 1 1 

.MOVEPENA * 709 

The next figure is 0.5 inches high and is printed at all four 
rotations; i.e. 0, 90, 180, and 270 degrees. 

.CONVERTF FIGFILE ARROW RAST2 * 0.5 1 * 

.LOAD RAST2 2 

.PRINTR 2 2 4.25 11 

.CONVERTF FIGFILE ARROW RAST3 * 0.5 1 90 

.LOAD RAST3 3 

.PRINTR 3 4 4.25 1 1 

.CONVERTF FIGFILE ARROW RAST4 * 0.5 1 180 

.LOAD RAST4 4 

-PRINTR 445.75 11 

.CONVERTF FIGFILE ARROW RASTS * 0.5 1 270 

-LOAD RASTS 5 

-PRINTR 5 25.75 1 1 

.DEL 4 

-DEL 5 


A detailed explanation of the commands used in this text file is given on the next page. 
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LPS EXAMPLES 


LINE | COMMAND AND 
NO. PARAMETERS DESCRIPTION 


. CONVERTF [IGURE ] 
FIGFILE 

PRINTER 

RAST1 


2680a 
1.5 


1 

* 

. L[OADRASTER] 
RAST1 


1 


.PRINTR[ASTER] 
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Converts figure in a figure file to a raster image file 
Name of the figure file that contains the figure. 
Name of the figure to be converted. 

A name for the raster file that will contain the 
converted image. 

output device 

Height of the figure, measured in units specified in 
the next parameter. 

Units of measurement, where 1 = inches. 

Orientation for the converted figure with respect to 
the physical page; default rotation is 0 degrees. 


Loads the raster image created with CONVERTFIGURE 
into the Laser Printer memory. 

Name of the raster image file assigned with 
CONVERTFIGURE. 

A reference number assigned to the raster image. 


Prints the raster image created with CONVERTFIGURE and 
loaded into Laser Printer memory with LOADRASTER. 
Raster image number assigned with LOADRASTER. 
X-coordinate of the upper left corner of the printed 
image. 


Y-coordinate of the upper left corner of the printed 


image. 

Unit of measurement for X- and Y-coordinates, where 
1 = inches. 

Position mode of X- and Y-coordinates, where 1 
specifies that the origin is the absolute top left 
corner of logical page. 





LPS EXAMPLES 


LINE | COMMAND AND 
NO. | PARAMETERS DESCRIPTION 


.MOVEPENA[BS] Moves the Laser Printer pen relative to the absolute 
top left corner of the logical page; this positions 
the pen to begin printing the text following the figure 
Moves the pen 0 dots to the left which is the 
default (*) position. 

495 Moves the pen 654 dots down. 


. DEL[ETERASTER] Deletes a raster image from Laser Printer memory. 
4 | Number of the raster image to be deleted. 
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LPS EXAMPLES 


Example 2: Output 


The following figure is 1.5 inches high and is printed at 0 
degree rotation with respect to the physical page. 





The same figure has been moved to the right so that 
this text can be printed to the left of it. 





The next figure is 0.5 inch high and is printed at all four 
rotations - 0, $0, 180 and 270 degrees. 


Figure 4-6. Example 2 Output 
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Example 3: Batch Job 


LPS EXAMPLES 


The following is an example of a stream file that would initiate a batch job to run the LPS interpreter. 


*JOB JOBNAME.USER. ACCT 
'RUN LPS.PUB.SYS 

2680A 

LP.HPENV.SYS 

N 
MYFILE.MYGROUP.MYACCT 
tEOJ 


(output device) 
(environment file name) 
(non-interactive session) 
(input file) 
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ERROR MESSAGE MEANING 


20 Warning: ENDWRITEFIELD with 
no WRITEFIELD in progress - 
ignored. 


ACTION 


Check all ENDWRITEFIELD 
commands to ensure that they are 
paired with a WRITEFIELD 
command. 

















The Writefield command has 
not been used to begin printing 
text in a field on a form. 























Remove one of the INCLUDE 
commands from your text file. 


More than 15 files have been 
included, one within the other. 


Warning: INCLUDE commands 
nested too deep; 16th INCLUDE 
file ignored. 




















Check the INCLUDE command 


and verify the filename. 


The filename has been omitted 
or is not a valid filename. 


22 Invalid or missing include 
filename 



















Check the ACTIVATEPAGE and 
DEACTIVATEPAGE commands in 
your text file; check the logical 
page numbers in your 
environment file. 


The logical page number has 
been omitted or does not 
correspond to a logical page 
number in the environment file 
you are using. 


Invalid or missing logical page 
number. 

























Check the NEWFORM command in 
your text file; check the form 
name using IDSFORM; check that 
the form has been associated with 
a logical page in your 
environment file. 


The form name _ has. been 
omitted or is not on the current 
logical page. 


Invalid or missing form name. 


























Check the NEWSUBFORM command 
in your text file; check the 
subform name using IDSFORM; 
check that the form is associated 
with a logical page in your 
environment file. 


The subform name has been 
omitted or is not a subform 
name on the current form. 


Invalid or missing subform 


name 























Check the USEFONT command in 
your text file; check the character 
font numbers in your 
environment file. 


Invalid or missing primary font. | The primary font number has 
been omitted or does not 
correspond to a character font 
number in your environment 


file. 
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| ERROR MESSAGE MEANING 


27 Invalid or missing secondary 









The secondary font number has 









































font. been omitted or does not 
correspond to a character font 
number in your environment 
| file. 

28 Invalid or missing field name. The field name has_ been 

lomitted or is not a field name 
on the current form. 

29 Invalid or missing subfield. The subfield number has been 
omitted or is not a subfield in 
the current field. 

30 Invalid or missing comment|The comment character has 

character. been omitted or is not a useable 
character. 

31 Invalid or missing continuation | The continuation character has 

character. been omitted or is not a useable 
character. 

32 Invalid or missing control| The control character has been 

character. omitted or is not a_ useable 
character. 

33 Invalid or missing default | The default character has been 

character. omitted or is not a _ useable} 


character. 


















Check 
















ACTION 


Check the USEFONT command in 
your text file; check the character 
font numbers in your 
environment file. 













Check the WRITEFIELD command 
in your text file; use IDSFORM to 
check the field names in your 
form. 









Check the WRITEFIELD command 
in your text file; use IDSFORM to 
check the number of subfields in 
the current field. 









the COMMENTCHAR 
command in your text file; you: 
cannot use an ampersand, a 
comma or a space aS a comment 
character. 









Check the CONTINUECHAR 
command in your text file; you 
cannot use a comma or a Space as 
a continuation character. 











Check the CONTROLCHAR 
command in your text file; you 
cannot use an ampersand, a 
comma or a space as a control 
character. 








Check the DEFAULTCHAR 
command in your text file; you 
cannot use an ampersand, a 
comma or a space as a default 
character. 
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ERROR MESSAGE 


34 
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Invalid shift 


character. 


or missing 


Invalid or missing raser image 
number. 


Invalid or missing figure name. 


figure 


missing 


Invalid 
filename. 


or 


Invalid missing 


device. 


or output 


MEANING 


The shift character has been 
is not a_ useable 


omitted or 
character. 


The raster image number has 
been omitted, is not between 0 
and 31, or does not correspond 
to a raster image number 
assigned with LOADRASTER 


The figure name has been 
omitted or is not an existing 
figure in the specified figure 
file. 


The figure filename has been 
omitted or is not and existing 
figure file. 


The output device has been 
omitted or is not a_ useable 
device. 


ACTION 


Check the SHIFTCHAR command 
in your text file; you cannot use 
an ampersand, a comma or a space 
as a shift character. 





Check the LOADRASTER command 
to make sure the raster image 
number is between O and 31; 
check the DELETERASTER and 
PRINTRASTER commands to make 
sure the image you are deleting or 
printing corresponds to the raster 
image number assigned with 
LOADRASTER. 


Check the CONVERTFIGURE and 
PRINTFIGURE commands in your 
text file; use HPDRAW, 
HPEASYCHART or DSG/3000 
to check that your drawing or 
chart has been saved as a figure 
in the specified figure file. 


Check the CONVERTFIGURE and 
PRINTFIGURE commands in your 
text file; use HPDRAW, 
HPEASYCHART or DSG/3000 
to check the name of your figure 
file. 


Check the CONVERTF IGURE 
command in your text file; output 
device is either 2680A or 2688A. 






ERROR MESSAGE 


MEANING ACTION 


Check the CONVERTF IGURE 
command to make sure a 
raster filename has been 
assigned; check the 
FLASHRASTER, LOADRASTER and 
PRINTFIGURE commands to make 
sure the raster filename 
corresponds to the file created 
with CONVERTF IGURE. 




















The raster filename has been 
omitted or is not the name of a 
raster file created with 
CONVERTF IGURE. 


Invalid or missing raster 
filename. 



















| Check the CONVERTFIGURE and 
PRINTFIGURE commands in your 
text file; check the logical page 
dimensions in you environment 
file. 


Invalid or missing raster image 
height. 


The raster image height has 
been omitted or is outside the 
| boundaries of the logical page. 



















| Units of measurement has been 
omitted or is not between 0 and 
| 3. 


Invalid or missing units. 







Check the CONVERTFIGURE, 
FLASHRASTER, PRINTF IGURE 
and PRINTRASTER commands to 
make sure units are 0, 1, 2or 
3; where =dots, 1=inches, 
2=centimeters, 3=millimeters. 





















Invalid or missing raster image 
rotation. 


The raster image rotation has 
been omitted or is not a useable 
rotation. 


Raster image rotation must be 0, 
90, 180, or 270 degrees; 
CONVERTFIGURE rotation is with 
respect to the physical page; for 
PRINTFIGURE rotation is with 
respect to the logical page. 




























Invalid or missing x position. The x position has been omitted, 
is outside the boundaries of the 
logical page, or is a negative 
value used with absolute 


positioning. 


Check the MOVEPENABS , 
MOVEPENREL, FLASHRASTER, 
PRINTFIGURE and PRINTRASTER 
commands; check the logical page 
dimensions in your environment 
file; you cannot use a negative 
value with absolute positioning. 
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ERROR MESSAGE 


Invalid or missing y position. 


MEANING 


The y position has been omitted, 
}is outside the boundaries of the 
logical page, or is a negative 
value used with absolute 
positioning. 


ACTION 


Check the MOVEPENABS , 
MOVEPENREL, FLASHRASTER, 
PRINTFIGURE and PRINTRASTER 
commands; check the logical page 
dimensions in your environment 
file; you cannot use a negative 
value with absolute positioning. 













































Invalid or missing position 
mode. 


The position mode has been 
omitted or is not a _ useable 
value. 


Check the FLASHRASTER, 
PRINTFIGURE and PRINTRASTER 
commands; position mode must be 
0 for relative or 1 for absolute. 





























Check the PRINTFIGURE 
command; raster image type must 
be O for temporary, or 1 for 
permanent. 


The raster image type has been 
omitted or is not a useable 
value. 


Invalid or missing raster image 
type. 


























Carriage control option must be 
CCTL or NOCCTL; check the 
INCLUDE command. 


The carriage control option has 
been omitted or is not a useable 
value. 


Invalid or missing carriage 


control option. 




















Check the CONVERTRASTER 
command to make sure an output 
raster rile mame has been 
assigned. 


The input raster file name has 
been omitted or is not a useable 
value. 


Invalid or missing input raster 
file name. 






















Check the CONVERTRASTER 
command to make sure an output 
raster file name has. been 
assigned.. 


The output raster file name has 
been omitted or is not a useable 
value. 


Invalid or missing output raster 
file name. 


















Check command 
syntax. 


Unrecognized command. Invalid command. spelling and 
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ERROR MESSAGE | MEANING | 


The image width has been 
|omitted or is not a useable 
| value. 

















Invalid or missing image width. Check the raster image width in 


the CONVERTRASTER command. 












Invalid or missing raster scaling 
method. 


Check the CONVERTRASTER 
command, scaling method must be 
0, 1 or 2. 


The raster sacling method has 
been omitted or is not a useable 
value. 

























Invalid or missing raster scaling | 
threshold value. 


Check the CONVERTRASTER 
command, threshold value must 
be between | and 255. 


The raster scaling threshold 
value has been omitted or is not 
a useable value. 


























Check the CONVERTRASTER 
command; the inverse image 
option must be 0 or 1. 


The inverse image option value 
has been omitted or is not a 
useable value. 


Invalid or missing inverse image 
option. 

























Warning: No more room in 
WRITEFIELD buffer; remaining 
data ignored. 


Print less data or create a smaller 
field with IDSFORM. 


Only 4096 characters are 
allowed per field or subfield. 













Check the SELECTPAGE 
command; eject option must be 
PHYS or NOPHYS. 


Invalid or missing physical page 
eject option. 






The physical page eject option 
1\has been omitted or is not a 
useable value. 
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THIS PAGE SHOULD BE BLANK 
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Overview 


The programmatic interface can be used in 
conjunction with IFS/3000 to control the Laser 
Printer. Prior to application run time, you use 
IFS/3000 to create an environment file containing 
formatting specifications for the Laser Printer. 
The programmatic interface gives you additional 
control by enabling you to supply instructions to 
the printer dynamically at application run time. 


You can control the Laser Printer based on 
conditions that vary during run time, since 
application programs can programmatically detect 
these changes. You can control things such as the 
character font or form being printed or the 
location and direction of printing. You can print 
data into a form symbolically using field name 
independent of the location of the field. This 
means that you can change the position of fields in 
your form without having to make changes to the 
program that writes data into the form. Also, if 
you have the HP graphics software, you can print 
graphics output on the Laser Printer, as well as 
merge text and graphics at print time. 


The programmatic interface consists of procedures 
called intrinsics which manage the interface 
between your program and the instructions to the 
Laser Printer. 


These intrinsics refer to specifications in your 
environment file, such as character fonts and 
forms and the layout to be used to print the 
document. The intrinsics can be called from user 
programs written in COBOL, COBOL II, BASIC, 
FORTRAN, SPL, or PASCAL. See Appendix F for 
sample programs. 


Procedure Descriptions 


Figure 5-1 lists all programmatic intrinsics by 
function. The intrinsics can be divided into two 
groups. Each group requires specific software 
subsystem capabilities as follows: 


e Formatting intrinsics can be used if you have 
IFS/3000 (HP 36580) installed on your system. 


e The HP Graphics software (HP 36583) allows 
access to the Formatting intrinsics plus 
Graphics intrinsics. 


Figure ‘5-6 summarizes the formatting and 
graphics intrinsics. A full description of each 
intrinsic is listed alphabetically, following the 
summary. 


The HP non-graphics software includes all 
intrinsics in both groups. 
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FUNCTION INTRINSIC (HP36580 & HP36583 unless noted) 


PINITDEVICE 
PINITIALIZE 



















Initialization 





HP36580 
HP36580V 
PERRMSG 
PFONTINFO 
PFONTNUM 
PLOGPAGEINFO 
PSTATEINFO 
PSTRINGWIDTH 









Obtain information from the system 








PACTIVATEPAGE 
PDEACTIVATEPAGE 
PMOVE PENABS 
PMOVEPENREL 
PNEWF ORM 
PNEWPAGE 
PNEWPHYSPAGE 
PNEWSUBFORM 
PSELECT PAGE 
PUSEF ONT 
PWRITEFIELD 


















Provide information to the system 





PCONVERTFIGURE (only with HP 36583) 
PCONVERTRASTER (only with HP 36583) 
PDELETERASTER (only with HP 36583 
PFIGUREINFO (only with HP 36583) 
PFLASHRASTER (only with HP 36583) 
PLOADRASTER (only with HP 36583) 
PPRINTFIGURE (only with HP 36583) 
PPRINTRASTER (only with HP 36583) 













Graphics Procedures 


Figure 5-1. Functional Listing of the Programmatic Intrinsics 
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Cailing the Intrinsics 


For all programming language references in this 
manual, the following rules apply to the intrinsic 
parameters: 


e All parameters are passed by reference; a literal 
value cannot be used as a parameter. 


e Most intrinsics require a logical array, referred 
to as the comarea, to be used for the 
communication area. 


PROGRAMMATIC INTERFACE 


e No condition codes are returned; the status of 
the call is returned in the first word of the 
comarea. 


e All parameters are required. For those 
parameters that have defaults, you can pass 
values designated to indicate that the defaults 
should be used. 


PINITDEVICE or PINITIALIZE must be called. 
before any other intrinsics are used. 


Figure 5-2 shows the format of calls to the 
intrinsics from each language. 
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PROGRAMMATIC INTERFACE 


LANGUAGE INTRINSIC CALL Format 


COBOL CALL intrinsic "INTRINSICNAME" USING parameterl, parametere... 


| cop ir | CALL “INTRINSICNAME" USING parameterl, parameter2... 
rereay | eL TGIOIE Geren) 


| PASCAL INTRINSICNAME (parameterl,parameter2...); 




















Figure 5-2. Calling Intrinsics from Programming Languages 


Where: 

PROCEDURENAME Identifies the intrinsic being called. 

parameter At least one parameter is required for most intrinsics; the particular parameters 
used with an intrinsic are listed in the individual intrinsic descriptions which 
follow in this section. When more than one parameter is specified, each is 
separated by a comma; for COBOL, they are separated by an optional comma and 
a required space. 
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Capabilities 


All programs which call the IFS/3000 intrinsics 
must be PREPAREd with the following user 
capabilities: 


PH (Process Handling) 
DS (Extra Data Segments) 
MR (Multiple RINs) 


For more information on the MPE :PREPARE 
command, refer to the MPE Segmenter Reference 


BYTE ARRAY 


DISPLAY 
PIC X(n) 


LOGICAL PIC $9(4) COMP 
ARRAY occurs n times 


INTEGER PIC $9(4) COMP 


CHARACTER 


LOGICAL 
ARRAY ARRAY 


INTEGER 





PROGRAMMATIC INTERFACE 


Manual (part number 30000-90045). If you have 
any questions about your user capabilities, contact 
your System Manager. 


Parameter Data Types 


The data types that are allowed for the parameters 
used in the intrinsics are shown in Figure 5-3. 


FORTRAN PASCAL 


STRING PACKED ARRAY 


OF CHAR 
INTEGER ARRAY OF 
SmallInteger 
(SmallInteger= 
-32768. .32767) 
INTEGER INTEGER SUBRANGE 
WITHIN THE RANGE 
-32768. .32767 


REAL 


On the HP 3000, each word is two bytes which is equivalent to 16 bits 


Figure 5-3. Data Types Allowed for Various Languages 
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PROGRAMMATIC INTERFACE 


In the discussion of the intrinsics, each parameter 
is identified according to its type as defined in 
SPL. This table is provided for those languages 
that do not call their data types by these particular 


names. 
| NOTE 


*Note the special handling of real values in 
COBOL in Figure 5-3. Since COBOL does 
not handle real data values, IFS/3000 
provides an ASCII version for intrinsics 
that must pass real values. These intrinsics 
are denoted by an "A" after the intrinsic 
name. For example, PCONVERTFIGURE 
becomes PCONVERTFIGUREA when used to 
pass real values in COBOL. The real 
parameter is a string that must contain a 
real number 16 characters long, padded 
with blanks if necessary. The real number 
itself consists of an integer part, a decimal 
point, and a decimal fraction part. A 
leading sign can be used; if not used, the 
default is a positive value. 


Byte Arrays 


For all languages except BASIC, byte arrays are 
terminated in one of two ways depending on 
whether the array is of fixed or variable length. 
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When you pass a parameter which is a fixed length 
character array, you must terminate the array 
with a blank, an EOS (end of string), or use the 
entire array. An EOS character is the ASCII value 
255. When an intrinsic returns a fixed length 
character array to you, it fills the array with 
trailing blanks until it reaches the maximum 
length. Fixed length character arrays are used for 
parameters such as character font name, form 
name, and subform name. 


In BASIC, the intrinsic determines the length of a 
byte array from the array itself, so you do not have 
to terminate the array as required for other 
languages. For variable length arrays, you must 
supply a dummy variable in the array length 
parameter even though BASIC does not use this 
parameter. When an intrinsic returns a byte array 
to you in BASIC, it sets the array to the 
appropriate length (not including any trailing 
blanks) and, where appropriate, returns the length 
of the array. 


Communication Area 


Every program must allocate a data area for 
communication with the intrinsics. Most intrinsics 
require as their first parameter a logical array 
referred to as the Comarea, or communication 
area. This area sets up space for: 


communication with you 

communication among intrinsics 

information necessary for performing symbolic 

access to fields in forms 

e information about character fonts and logical 
pages 

e information about raster images 


(SPL) 
WORD OFFSET 


Integer 
Integer Error number 
Integer 


Integer 


Integer 


User area status 


Error parameter 1 
Error parameter 2 


Message catalog file number 


PROGRAMMATIC INTERFACE 


The space required for the comarea depends on 
the contents of the environment file. After you 
compile your environment, IFS/3000 displays the 
space required for the comarea on the IFS/3000 
Main Menu. The space required is expressed in 
number of words. It is displayed only if the 
environment file has not been changed since it was 
last compiled. As soon as the file is changed, the 
number is blanked out. Once the changed file has 
been successfully compiled, the space required for 
the comarea is displayed. 


As shown below, the comarea array contains 
information about errors that occur when the 
intrinsics are called. The status of the intrinsic 
call and error information is returned in the first 6 


words of the comarea. Each word is two bytes 
which is equivalent to 16 bits. 


FUNCTION 


status of calls 
See Appendix G 
error information 
error information 


error information 


BA | Error string - 80 bytes 


Integer 27f-end 26-end 





RESERVED FOR SYSTEM USE 


Figure 5-4. Outline of the comarea Contents 
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PROGRAMMATIC INTERFACE 
User Area Status 


The first word (offset 0) is the user area status 
word. When a intrinsic is called, it sets the user 
area status word to indicate the status of the 
intrinsic call as shown in Figure 5-5. 


A successful call to any intrinsic sets the value of 
the user area status word to 0. If a intrinsic call 
causes a warning, the user area status word is set to 
1. If a call to an intrinsic fails, it sets the user area 
status word to 2. 


MEANING 


Successful call to intrinsic 


WARNING 


ERROR OCCURRED set by 
failed intrinsic 





Figure 5-5. User Area Status Word Values 


Error Number 


An appropriate error or warning message can be 
obtained by calling PERRMSG. The error number is 
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available in the second word of the comarea. The 
error message corresponding to this number can be 
found in Appendix G. 


Error Parameters 1 and 2 


If an error occurs, the third and fourth words of 
the comarea are used to return information about 
the error, such as the file system error number. 


String Parameter in an Error 


If an error contains a string parameter, the string 
parameter begins in the sixth word of the 
comarea. The maximum length of the string is 80 
bytes, including the EOS used to terminate the 
string. The string parameter is used to return 
items such as invalid character font or filename. 


Message Catalog File Number 


This is the file system number for the IFS/3000 
message catalog (PMSGCAT. PUB. SYS). 


To run programs calling PERRMSG, the IFS/3000 
message catalog must be available on your system. 





Examples of defining the comarea follow. In all examples, nnnn is greater than or equal to the number of 
words required for the comarea as displayed on the IFS/3000 Main Menu. In the detailed examples that 
follow the description of each intrinsic, the comarea definition is not shown each time. Refer to the 
examples below for all instances of defining the comarea. 


COBOL II: DATA DIVISION. 
O01 comarea. 
03 Status pic $9(4) 
03 ErrorNumber pic $9(4) 
03 ErrorParml pic S$9(4) 
03 ErrorParm2 pic $9(4) 
03 Msgfilenumber pic S9(4) 
03 ErrorString pic X(40). 
03 SystemInfo pic $9(4) 
BASIC: 540 REM Cl is comarea 
550 REM Ci[1] is Status 
560 REM Cl1[2] is ErrorNumber 
570 REM C1[3] is ErrorParml 
580 REM C1[4] is ErrorParm2 
590 REM C1[5] is Msgfilenumber 
600 REM Cl1[6] is ErrorString 
610 Integer Cl[nnnn] 
FORTRAN: Integer comarea(nnnn) 
Integer 


Status,ErrorNumber,ErrorParml ,ErrorParm2 ,Msgfilenumber 


occurs nnnn times. 


character *80 ErrorString 


Equivalence 
Equivalence 
Equivalence 
Equivalence 
Equivalence 
Equivalence 


(comarea(1),Status) 
(comarea(2),ErrorNumber) 
(comarea(3),ErrorParm1) 
(comarea(4) ,ErrorParm2) 
(comarea(5) ,Msgfilenumber) 
(comarea(6),ErrorString(1)) 


comp. 
comp. 
comp. 
comp. 
comp. 


comp 
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SPL: Logical Array comarea(O:nnnn); 


Define Status = comarea(0) #, 
ErrorNumber = comarea(1) #, 
ErrorParml = comarea(2) #, 
ErrorParm2 = comarea(3) #, 
Msgfilenumber = comarea(4) #; 
PASCAL: type 


SmallInteger = -32768..32767; 


var 
comarea = record 
Status, 
ErrorNumber, 
ErrorParml , 
ErrorParme, 
Msgfilenumber : SmallInteger; 
ErrorString : packed array [1..80] of char; 
SystemInfo : array [l..nnnn] of SmallInteger; 
end; 
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INTRINSICS 


HP36580 
HP36580V 

PACTIVATEPAGE 
PCONVERTF IGURE 
PCONVERTRASTER 








































PDEACTIVATEPAGE 
PDELETERASTER 
PERRMSG 

PF IGUREINFO 
















PFLASHRASTER 











PFONTNUM 
PINITDEVICE 














PINITIALIZE 













PLOADRASTER 
PLOGPAGEINFO 











Prints the version number of the IFS/3000 intrinsics. 
Returns the version number of the IFS/3000 intrinsics. 
Activates a logical page. 

Converts a figure in a figure file to a raster image file. 

Accepts raster data graphics generated by custom software, 
or external hardware, or which is otherwise incompatible 
with HP/3000 supported subsystem processing. The basic 
image can be manipulated, including rotation and 
scaling, and a formatted raster image file is created 
which is printable on the Laser Printer. 

Deactivates a logical page. 

Deletes a raster image from Laser Printer memory. 

Returns the message associated with an error code. 

Returns information about a raster imagefile or a figure 
in a figure file. 

Loads a raster image into Laser Printer memory, prints it, 
then deletes it from Laser Printer memory. 

Returns the number of a character font. 

Initializes the COMAREA, identifies the programming 
language used, the spool file number, and the output 
device. 

Initializes the COMAREA, identifies the programming 
language used and the spool file number. 

Loads a raster image into Laser Printer memory. 

Returns logical page information. 


Figure 5-6. IFS/3000 Intrinsics Summary 
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IFS/3000 Programmatic Intrinsics 


FUNCTION 


Moves the Laser Printer pen relative to the upper 
left corner of the logical page. 

Moves the Laser Printer pen relative to its current 
position. 


| INTRINSICS 


PMOVEPENABS 













PMOVEPENREL 


























PNEWFORM Selects the form you want to write to. 
PNEWPAGE Advances to the next logical page. 
PNEWPHYS PAGE Advances to the next physical page. 
PNEWSUBFORM Selects the subform you want to write to. 


PPRINTFIGURE Converts a figure in a figure file to a raster image file, 
then loads and prints the raster image and deletes it. 
from printer memory. 

Prints a raster image loaded via the LOADRASTER command 

Activates and advances to the selected logical page. 
Optionally performs a physical page eject. 

Returns information about the current state of the print job 

Returns the width of a character string in dots. 

Selects primary and secondard character fonts. 

Writes data to a field or subfield in a form. 
















PPRINTRASTER 
PSELECT PAGE 





























PSTATEINFO 
PSTRINGWIDTH 
PUSEFONT 

PWRITEFIELD 





Figure 5-6. IFS/3000 Intrinsics Summary (con't. ) 
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HP36580 


Prints the version number of the IFS/3000 intrinsics currently installed on your system. 


Syntax 


HP36580 


Parameters 


NONE 


Discussion 
The HP36580 intrinsic prints the following message to $STDLIST: 
The current version of the IFS/3000 intrinsics is v.uu.ff 


where v is the major product enhancement level, uu is the product update level, and ff is the product fix 
level. 
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HP36580V 


Returns the version number of the IFS/3000 intrinsics currently installed on your system. 


Syntax 


LA 
HP36580V (version) 


out 





Parameters 

version Logical array used to return the version number of the intrinsics installed on 
your system. This array must be at least 8 words long and is terminated by an 
EOS when returned to you. 

Discussion 


When communicating information or problems to Hewlett-Packard, it is helpful to provide the IFS/3000 
version number. 


The version number returned to you is in the format HP36580v.uu.ff, where HP36580 is the IFS/3000 
product number, v is the major product enhancement level uu is the product update level, and ff is the 
product fix level. 


Example 
COBOL II: DATA DIVISION. 
version pic $9(4) comp 
occurs 8 times. 
Jan 84 
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BASIC: 


FORTRAN : 


SPL: 


PASCAL : 


PROCEDURE DIVISION. 


CALL INTRINSIC “HP36580V" USING version. 


500 CALL HP36580V (V1 [*])} 
CALL HP36580V (version) 
HP36580V (version); 


HP36580V (version); 


HP 36580V 
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PACTIVATEPAGE 


Activates a particular logical page. 


Syntax 


LA I 
PACTIVATEPAGE (comarea,pagenumber) 


¢ 


infout in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

pagenumber Integer variable used to supply the number of the logical page you want to 
activate. pagenumber must have a value between 0 and 31, inclusive. 

Discussion 


IFS/3000 manages logical pages by number in the Logical Page Table, and determines which page to print 
next by cycling through this table. By calling PACTIVATEPAGE and its counterpart PDEACTIVATEPAGE, you 
set an indicator in the Logical Page Table indicating which logical pages are currently active. If a logical 
page is not currently active, it is skipped and is not printed. 


If there are no logical pages defined in the environment, the Laser Printer default logical page is assumed to 
be active. 
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Exampie 


COBOL IT: 


BASIC: 


FORTRAN: 


SPL: 


PASCAL: 


PACTIVATEPAGE 


DATA DIVISION. 

Ol pagenumber pic S9(4) comp. 

PROCEDURE DIVISION. 

CALL INTRINSIC "“PACTIVATEPAGE" USING comarea, 
pagenumber . 

700 CALL PACTIVATEPAGE (C1[*],P1) 

CALL PACTIVATEPAGE (comarea,pagenumber) 

PACTIVATEPAGE (comarea,pagenumber) ; 


PACTIVATEPAGE (comarea,pagenumber); 
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PCONVERTFIGURE[A] 


Converts a figure in a figure file into a partitioned raster image file which is the format required for printing 
by the Laser Printer. The ASCII version, callable from COBOL, is denoted by an "A" after the intrinsic name. 


Syntax 


LA BA BA BA 
PCONVERTFIGURE (comarea,figurefilename, figurename,rasterfilename, 
in/out in in in 


BA R I I 
outputdevice ,imageheight ,units,imagerotation) 
in in in in 





Parameters 


comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


figurefilename Byte array used to supply the name of the figure file that contains the figure 
you want to convert. This array can be up to 35 characters to allow for a fully 
qualified MPE filename. If the filename is less than 35 characters, it must be 
terminated by a blank or an EOS. In BASIC a. blank or EOS is not necessary 
since the length is determined from the array itself. 


figurename Byte array used to supply the name of the figure within the specified figure 
file that you want to convert. This array can be up to 16 characters (upper or 
lower case) beginning with a letter, and cannot include any embedded blanks. 
If figurename is less than 16 characters, it must be terminated by a blank or 
an EOS. In BASIC a blank or EOS is not necessary since the length is 
determined from the array itself. 
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rasterfilename 


out putdevice 


imageheight 


units 


imagerotatton 


PCONVERTFIGURE[A] 


Byte array used to supply the name of the partitioned raster image file that 
will contain the converted figure. This array can be up to 35 characters to 
allow for a fully qualified MPE filename. It must be terminated by a blank, an 
EOS, or the 35th character, except in BASIC. 


Byte array used to supply the name of the output device for which the figure is 
to be converted. This array can be up to 7 characters and must be terminated 
by a blank, an EOS, or the 7th character. In BASIC, the length is determined 
from the array itself. 


Real variable used to supply the height of the partitioned raster image, viewed 
in the direction of its orientation, and given in the units specified in the units 
parameter. The width is automatically calculated from the imageheight 
value. For COBOL, the value is passed as an ASCII string. Refer to Section 2 
on Terminology for more information on image height and orientation. One 
dot is added to the height when the image is converted; that is, a specified 
height of 300 dots creates an image 301 dots high. You only need to take this 
into account if you are working with extremely precise dot measurements. 


Integer variable used to supply the unit of measurement to be used for 
imageheight. units must have a value of 0, 1, 2 or 3. 


0 = Dots 

1 = Inches 

2 = Centimeters 
3 = Millimeters 


Integer variable used to supply the orientation of the partitioned raster image 
with respect to the physical page; must have a value of 0, 90, 180 or 270 
degrees. Refer to Section 2 on Terminology for more information on 
partitioned raster image rotation. 


Jan 84 
5-19 


PCONVERTFIGURE[A] 


Discussion 


PCONVERTFIGURE converts a figure in a figure file into a partitioned raster image file which is the format 
required for printing by the Laser Printer. The rasterfilename you specify here is later used with the 
PLOADRASTER or PFLASHRASTER intrinsic. 


Example 
COBOL ITI: DATA DIVISION. 
01 figurefilename pic X(35). 
01 figurename pic X(16). 
01 rasterfilename pic X(35). 
01 outputdevice pic X(8). 
Oi imageheight pic X(16). 
01 units pic S9(4) comp. 
01 <imagerotation pic S9(4) comp. 
PROCEDURE DIVISION. 
CALL INTRINSIC "PCONVERTFIGUREA" USING comarea , 
figurefilename, 
figurename , 
rasterfilename , 
outputdevice, 
tmageheight , 
units, 
imagerotation. 
BASIC: CALL PCONVERTFIGURE (Cl [*] ,F1$,F2$,R1$,D1$,H,U,R) 
FORTRAN: CALL PCONVERTFIGURE (comarea,figurefilename,figurename, 
& rasterfilename ,outputdevice,imageheight units, 
& imagerotation) 
Jan 84 


$-20 


PCONVERTFIGURE[A] 


SPL: PCONVERTFIGURE (comarea, figurefilename ,figurename ,rasterfilename, 
out putdevice ,imageheight ,units,imagerotation); 


PASCAL: PCONVERTFIGURE (comarea, figurefilename, figurename ,rasterfilename , 
out putdevice ,imageheight ,units,imagerotation); 
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PCONVERTRASTER[A] 


Accepts dot-per-bit raster data graphics. The basic image can be manipulated, including rotation and scaling, 
and a partitioned raster image file is created which is printable on the Laser Printer. The ASCII version, 
callable from COBOL, is denoted by an "A" after the intrinsic name. 


Syntax 


LA BA BA BA 
PCONVERTRASTER (comarea,inrasterfilename ,outrasterfilename, outputdevice, 
in/out in in in 


R R TA 
imageheight ,imagewidth ,convertarray) 
in in in 





Parameters 


comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


inrasterfilename Byte array used to supply the name of the partitioned raster file that you want 
to manipulate. This array can be up to 35 characters (upper or lower case) 
beginning with a letter, and cannot include any embedded blanks. If 
inrasterfilename is less than 35 characters, it must be terminated with a 
blank or an EOS. In BASIC, a blank or EOS is not necessary since the length is 
determined from the array itself. 


outrasterfilename Byte array used to supply the name of the dot-per-bit raster image file that 
will contain the partitioned partitioned raster image. This array can be up to 
35 characters to allow for a fully qualified MPE filename. It must be 
terminated by a blank, an EOS, or the 35th character, except in BASIC. The 
file code for a partitioned raster image file is 1114 or RASTR. 
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outputdevice 


imageheight 


imagewidth 


convertarray 


units 


imagerotation 


PCONVERTRASTER[A] 


Byte array used to supply the name of the output device for which the figure 1s 
to be converted. This array can be up to 7 characters and must be terminated 
by a blank, an EOS, or the 7th character. In BASIC, the length is determined 
from the array itself. 


Real variable used to supply the height of the partitioned raster image, viewed 
in the direction of its orientation, prior to rotation, and given in the units 
specified in the units parameter. For COBOL, the value is passed as an ASCII 
string. Refer to Section 2 0n Terminology for more information on image 
height and orientation. 


Real variable used to supply the width of the partitioned raster image, prior to 
rotation, given in the units specified in the units parameter. For COBOL, the 
value is passed an ASCII string. 


Note: Both imageheight and imagewidth are required parameters and the ratio 
aspects must be calculated for each. 
Integer array containing the following five integer values: 

Integer variable used to supply the unit of measurement to be used for 


imageheight and imagewidth. The units must have a value of 0, 
1, 2 or 3, where: 


0 = dots 

1 = inches 

2 = centimeters 
3 = millimeters 


Integer variable used to supply the orientation of the printed raster 
image with respect to the physical page. Imagerotation must have 
a value of 0, 90, 180 or 270. Refer to Section 2 on Terminology for 
more information on partitioned raster image rotation. 


The temporary file, ROTATEFL, is created which can be saved and 
used separately. 
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PCONVERTRASTER[A] 


scalingmethod Integer variable used to supply the method used to scale the raster 
image. scalingmethod must have a value of 0, 1, 2. For any one of 
the following integers specified, the temporary file, SCALEFL, is 
created which can be saved and used separately. 


O= Threshold testing only. This method uses the input threshold 
defined in word four, or calculates a default threshold which 
serves as a scaled dot comparison value. This method has the 
best general performance and does well at scaling line art 
graphics. | 


1= Pattern recognition. This method attempts to duplicate the 
pattern of the source image by repeating the pattern in the 
scaled image. It is more CPU intensive but should give better 
results in scaled patterns and text. 


2= Randomized threshold testing. This method is best used in 
grey tone picture scaling where there are few defined hard 
lines. This method is CPU intensive. The thresholdvalue in 
word four can be used to generally increase or decrease the 
lightness of the scaled image. 


thresholdvalue Integer variable used to specify a threshold between 1 and 255 which 
is used in the scaling routines. If the value is zero the scaling routine 
will calculate a default threshold based on the scaling factor. This 
value is passed only if scalingmethod = Oor 2. By increasing the 
threshold the scaled image becomes generally lighter. 


tnverseoption Integer variable used to specify inverse image as = 1, or normal 
(non-inverse) image as = 0. The temporary file, INVERSEL, is created 
and can be saved and used separately. 
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PCONVERTRASTER[A] 


Discussion 

PCONVERTRASTER accepts a dot-per-bit raster file. The basic image can be manipulated, including rotation 
and scaling, and a partitioned raster image file is created which is printable on the Laser Printer. The 
outrasterfilename you specify here is used later with the PLOADRASTER or PFLASHRASTER intrinsics. 


The requirements for the input raster data are: 


1. The existing partitioned raster file must be a permanent disc file with fixed record length, where 
each logical record represents a left to right raster scan line. 


2. The raster data records must be binary with one bit-per-pixel where there is a one-to-one 
correspondence between each bit turned on and each dot of the printed scan line. 


3. Each scan line (record) can be a maximum of 124 words (1980 dots) in length, and there cannot be 
more than 3060 scan lines (records) in total. 


PCONVERTRASTER performs as many as four separate functions depending on the values assigned in the 
parameter list. Each function creates a separate temporary file of raster data which can be saved and used 
separately. 

Efficiency is increased by determining which function will create a basic temporary file suitable for multiple 
format manipulation without repeating the basic function. As an example, scaling a basic image before 
multiple rotations of the image would be more efficient than rescaling multiple rotations. 


Example 


COBOL II: DATA DIVISION. 


Ol inrasterfilename pic X(35). 
01 outrasterfilename pic X(35). 
01 outputdevice pic X(8). 
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PCONVERTRASTER[A] 


Ol imageheight pic X(16). 

Ol tmagewidth pic X(16). 

01 convertarray. 
05 units pic S9(4) comp. 
OS imagerotation pic S9(4) comp. 
05 scalingmethod pic S9(4) comp. 
05 thresholdvalue pic S9(4) comp. 
05 inverseoption pic S9(4) comp. 
OS Filler pic S9(4) comp 


occurs 15 times. 
PROCEDURE DIVISION. 


CALL INTRINSIC "“PCONVERTRASTERA" USING comarea, 
inrasterfilename, 
outrasterfilename, 
out putdevice, 
imageheight , 
imagewidth , 
convertarray. 


BASIC: CALL PCONVERTRASTER (C[*] ,F1$,F2$,D1$,H,W,L[*] ) 


FORTRAN: CALL PCONVERTRASTER (comarea,inrasterfilename ,outrasterfilename , 
& out putdevice,imageheight ,imagewidth,convertarray) 


SPL: PCONVERTRASTER (comarea,inrasterfilename ,outrasterfilename, 
out putdevice ,imageheight ,imagewidth ,convertarray) ; 


PASCAL: PCONVERTRASTER (comarea,inrasterfilename outrasterfilename, 
out putdevice,imageheight ,imagewidth,convertarray) ; 
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PDEACTIVATEPAGE 


Deactivates a particular logical page. 


Syntax 


LA I 
PDEACTIVATEPAGE (comarea,pagenumber) 


in/out in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

pagenumber Integer variable used to supply the page number of the logical page you want to 
deactivate. pagenumber must have a value between 0 and 31, inclusive. 

Discussion 


Refer to the discussion of PACTIVATEPAGE in this section. 


There must always be at least one logical page active in a job when attempting to print to the printer. 
PDEACTIVATEPAGE returns a warning if you try to deactivate the only active page. If there are no logical 
pages defined in the environment, the Laser Printer default logical page is assumed to be active. 
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PDEACTIVATEPAGE 


Example 


COBOL ITI: 


BASIC: 
FORTRAN: 
SPL: 


PASCAL: 


Jan 8&4 
5-28 


DATA DIVISION. 
01 pagenumber pic S9(4) comp. 
PROCEDURE DIVISION. 


CALL INTRINSIC "“PDEACTIVATEPAGE" USING comarea, 
pagenumber. 


700 CALL PDEACTIVATEPAGE (C1i[*],P1) 
CALL PDEACTIVATEPAGE (comarea,pagenumber) 
PDEACTIVATEPAGE (comarea,pagenumber); 


PDEACTIVATEPAGE (comarea,pagenumber); 


PDELETERASTER 


Deletes a partitioned raster image from Laser Printer memory. 


Syntax 


LA I 
PDELETERASTER (comarea,imagenumber) 


* 


in/out in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

imagenumber Integer variable used to supply the number of the partitioned raster image to be 
deleted. ztmagenumber must have a value between 0 and 31 and must be the 
number of an image that has already been loaded with the PLOADRASTER 
intrinsic. 

Discussion 


A partitioned raster image can be deleted from Laser Printer memory only if it has already been loaded with 
the PLOADRASTER intrinsic. PDELETERASTER would normally be used after your last reference to the 
partitioned raster image with the PPRINTRASTER intrinsic. 
Example 

COBOL II: DATA DIVISION. 


Ol <wtmagenumber pic S9(4) comp. 
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PDELETERASTER 


BASIC: 


FORTRAN: 


SPL: 


PASCAL: 
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PROCEDURE DIVISION. 


CALL INTRINSIC "“PDELETERASTER" USING comarea, 
imagenumber . 


600 CALL PDELETERASTER (C1[*],12) 
CALL PDELETERASTER (comarea,imagenumber) 
PDELETERASTER (comarea,imagenumber) ; 


PDELETERASTER (comarea,imagenumber); 


PERRMSG 


Returns the error or warning message associated with the error number received when a call to an intrinsic is 


not successful. 


Syntax 


LA 


BA I I 


PERRMSG (comarea,errormessage ,arraylength,messagelength) 


in/out 


out in out 





Parameters 


comred 


errormessage 


arraylength 


messagelength 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Byte array used to return the error message for an error which occurs after a 
call to an IFS/3000 intrinsic. The error message is padded with blanks to the 
end of array. This array must be at least 80 bytes long to avoid truncating any 
error messages. 


Integer variable used to supply the length of the error message array. In 
BASIC, the maximum length of the error message is determined from the array 
itself, but you must supply a dummy variable for this parameter. 


Integer variable used to return the length of the error message itself, not 
including any trailing blanks. In BASIC, you can use a dummy variable since 
the length is set by the string itself. 
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Discussion 


The first word of the comarea returns the status of an intrinsic call. If the status is not set to O, the intrinsic 
call has failed, and you should call PERRMSG to get the message associated with the error. If the call to 
PERRMSG is successful, PERRMSG sets the status word in the comarea to 0. If PERRMSG fails, it returns an 
appropriate error message but does not reset the error indication in the comarea. 


If you call PERRMSG twice in a row, PERRMSG fails since there is no error the second time. It returns an 
appropriate error message in the error message array, but does not reset the error indication in the comarea. 


PERRMSG depends on the IFS/3000 message catalog (PMSGCAT. PUB. SYS). To run programs calling 
PERRMSG, you must have the IFS/3000 message catalog available on your system. 


Example 


COBOL II: DATA DIVISION. 


Ol errormessage pic X(80). 
01 arraylength pic S9(4) comp. 
01 messagelength pic S9(4) comp. 


PROCEDURE DIVISION. 


CALL INTRINSIC “PERRMSG" USING comarea, 
errormessage, 
arraylength, 
messagelength. 


BASIC: 550 CALL PERRMSG (C1[*] ,E1$,E1,£2) 


FORTRAN: CALL PERRMSG (comarea ,errormessage ,arraylength ,messagelength) 


SPL: PERRMSG (comarea,errormessage ,arraylength ,messagelength) ; 
PASCAL: PERRMSG (comarea ,errormessage ,arraylength ,messagelength) ; 
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Returns information about a partitioned raster image file or a figure in a figure file. The ASCII version, 
callable by COBOL when a real data type is required, is denoted by an "A" after the intrinsic name. 


Syntax 


LA BA I I LA I 
PFIGUREINFO (comarea, filename, filetype,itemnumber ,itemvalue,itemlength) 


in/out in in/out in out out 





Parameters 


comarea 


filename 


filetype 


ittemnumber 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Byte array used to supply the name of the figure and figure file or the 
partitioned raster image file for which you want information. This array can 
be up to 52 characters long, terminated by a blank, an EOS, or the 52nd 
character. In BASIC, the length is determined by the array itself. The figure 
filename must be followed by a figure name which must be separated from the 
filename by a colon (:) and followed by a blank or an EOS (e.g. 
filename: figurename). You cannot specify a figure name with a 
partitioned raster image file. 


Integer variable used to supply or return the kind of file specified in the 
filename parameter. File type must have a value of -1, 0, or 1. 


Unknown Type (the actual type is returned in this parameter) 
Raster Image File 


-1 
0 
1 Figure in a Figure File 


Integer variable used to supply the number of the item which is to be returned. 
See Figure 5-7 for a description of item numbers. 
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ttemvalue 


itemlength 


FILE TYPE 


Raster 


Raster 


Raster 
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Returns the information requested for a particular item. See Figure 5-7 for 
data types to be used with different items. For COBOL, an ASCII string is 
returned if this parameter is a real value. 


Integer variable used to return the length of the itemvalue parameter in 


bytes. The ttemlengths required for different itemnumbers are provided in 
Figure 5-7 on the following pages. 


DATA TYPE LENGTH 


Byte Array Name of the output device 


Keal Array Resolution of the output device, 
measured in number of dots per unit 
given in item 3. 


Array(1) = horizontal resolution 
Array(2) = vertical resolution 


Integer Units used to measure output device 
resolution given in item 2. 


1 = Inches 
2 Centimeters 
3 = Millimeters 


Figure 5-7. Information Available from PFIGUREINFO 


ITEM FILE TYPE 


NO. 


4 Raster or 


Figure 
5 Raster 
6 Raster 


7 Raster 


8 Raster or 
Figure 


DATA TYPE 


Real Array 


Real 


Integer 


Byte Array 


Byte Array 


LENGTH 


16 bytes* 


4 bytes* 


2 bytes 


Variable 
Length 


8 bytes 


PFIGUREINFO[A] 





Minimum and maximum X and Y values 
of the raster image or figure. 
Raster image units are given in item 
3. Figure units are given in a 100 
x 100 unit figure space. 


Array(1) = minimum X value 
Array(2) = maximum X value 
Array(3) = minimum Y value 
Array(4) = maximum Y value 


Orientation of the raster image. 
Ranges from 0.0 to 360.0 degrees. 


Source from which the raster image 
was generated. 


0 
1 


unknown 
figure in figure file 


Name of the source given in item 6. 


Bytes 1-16 
Bytes 17-52 


figure name 
figure file name 


Version of IFS/3000 that created 
the raster image, in the format 
v.uu.ff 


v= major enhancement level 
uu = update level 
ff = fix level 


Figure 5-7. Information Available from PF IGUREINFO (cont. ) 
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ITEM 
NO. 








FILE TYPE DATA TYPE LENGTH ITEM 








Raster Unsigned Date the raster image or figure was 
Figure Logical created or last modified, in the same 
format as the MPE CALENDAR intrinsic. 








Raster or  Doubleword 4 bytes Time the raster image or figure was 
Figure created or last modified, in the same 
format as the MPE CLOCK intrinsic. 











Raster or Unsigned 2 bytes System crash indicator. If TRUE, 
Figure Logical integrity of raster image or figure 
is questionable. 












Raster Real Array 8 bytes* Smallest and largest text sizes 
Figure contained in the image. 
Values represent the proportion 
of the cell height to the total 
figure or raster image height. 
















Array(1) = Smallest Text Proportion 
Array(2) = Largest Text Proportion 








13 RESERVED FOR SYSTEM USE 










Raster Doubleword 4 bytes Number of vectors used to create the 
raster image 









Raster Integer 8 bytes Distance in dots from the 4 borders 

Array of the raster image to the upper 
left corner of the image. 

Array(1) Left border 

Array(2) = Right border 

Array(3) = Top border 

Array(4) = Bottom border 



















Figure 5-7. Information Available from PFIGUREINFO (cont.) 
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FILE TYPE DATA TYPE LENGTH 


Figure Unsigned 2 bytes Date the figure was created, in 
Logical the same format as the MPE 
CALENDAR intrinsic. 


Doubleword Time the figure was created, in 
the same format as the MPE CLOCK 
intrinsic. 


Raster Integer The number of bits used to store 
each element in the raster image 
file. 


Byte Array 128 bytes Comment stored in the figure header. 





Figure 5-7. Information Available from PFIGUREINFO (cont. ) 


* COBOL requires a larger array for real values than other languages. The length given in Figure 5-7 
should be multiplied by 4 when calling PFIGUREINFOA from COBOL; that is, a stated length of 4 bytes 
requires 16 bytes in COBOL, a length of 8 bytes requires 32, and so forth. 


Discussion 


PFIGUREINFO can be used to return information about a partitioned raster image file or a figure in a figure 
file. If you specify a figure file, you must also specify a figure name. Figure name is not applicable to a 
partitioned raster image file. If you specify a figure name with a raster image file, you will receive an error 
message. 


If you specify a figure in a figure file, only the MPE permanent file domain is searched. If you specify a 
partitioned raster file, the MPE temporary domain is searched first, followed by the permanent domain. 


If you request information about an item that is not applicable to the file type specified, PFIGUREINFO 


returns an item length of 0 and the contents of item value remain unchanged. 


Jan &4 
$-37 


PFIGUREINFO[A] 


Example 


COBOL II: 


BASIC: 
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DATA DIVISION. 


filename pic X(52) value spaces. 
filetype pic S9(4) comp. 
ttemlength pic $9(4) comp. 
ttemnumber pic S9(4) comp. 
ittemvalueDescription. 


03 


03 


03 


03 


03 


ttemvalue pic S9(4) comp 

occurs 64 times. 
ByteValue redefines itemvalue 

pic X(1) 

occurs 128 times. 
DoubleValue redefines itemvalue 

pic S9(9) comp 

occurs 32 times. 
IntegerValue redefines itemvalue 

pic S9(4) comp 

occurs 64 times. 
RealValue redefines itemvalue 

pic X(16) 
occurs 8 times. 


PROCEDURE DIVISION. 


CALL INTRINSIC "“PFIGUREINFOA" USING comarea, 


filename, 
filetype, 
ttemnumber , 
ttemvalue , 
itemlength. 


10 REM Cl is comarea 
20 REM Fl is filetype 


FORTRAN: 


SPL: 


PASCAL: 


PFIGUREINFO[A] 


30 REM Il is ttemnumber 

40 REM Li is itemlength 

50 REM F$ is filename 

60 DIM c1[1000], F$(35) 

100 REM Substitute a variable of the appropriate type 
110 REM for the "X", depending on the item requested 
120 REM 

130 CALL PFIGUREINFO (C1[*],F$,F1,I1,X,L1) 


Integer filetype,itemnumber ,itemlength 

Logical itemvalue(64) 

character*128 ByteValue 

Integer*4 DoubleValue 

Integer IntegerValue(4) 

Logical LogicalValue 

Real RealValue(4) 

Equivalence (ztemvalue(1) ,ByteValue,DoubleValue,IntegerValue, 
LogicalValue,RealValue(1)) 

character*35 filename 


CALL PFIGUREINFO (comarea,filename,filetype,itemnumber , 
itemvalue,itemlength) 


Integer filetype,itemnumber ,itemlength; 
Byte Array filename(0:34); 

Logical Array itemvalue(0:63); 

Byte Array ByteValue(*)=ztemvalue; 
Double DoubleValue=itemvalue; 

Integer Array IntegerValue(*)=itemvalue; 
Logical LogicalValue=itemvalue; 

Real Array RealValue(*)=itemvalue; 


PFIGUREINFO (comarea, filename, filetype,itemnumber ,itemvalue, 
itemlength); 
type 
SmallInteger = -32768..32767; 
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charS52array = packed array[1..52] of char; 
charl28array = packed array[1..128] of char; 
logical64array = array[1..64] of logical; 


itemrec = record 


dummy : 0..16; {align on word boundary} 
case rectag : itemtype of 
zlogical : (LogicalValue : logical64array); 
zchar : (ByteValue : charl28array); 
zdouble : (DoubleValue : integer); 
zreal : (RealValue : array[1..4] of real); 
zword : (WordValue : array[1..4] of SmallInteger); 
end; 


var 
filename  : charS2array; 
filetype  : Smallinteger; 
zttemnumber : SmallInteger; 
ttemvalue : itemrec; 
ttemlength : SmallInteger; 


PFIGUREINFO (comarea,filename,filetype,itemnumber ,itemvalue, 
itemlength); 
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Loads a partitioned raster image into Laser Printer memory, prints it, then deletes it from Laser Printer 
memory. The ASCII version, callable from COBOL, is denoted by an "A" after the intrinsic name. 


Syntax 


LA BA R R I I 


PFLASHRASTER (comarea,rasterfilename ,xzposition ,yposition ,units,posittonmode) 
in/out in in in in in 





Parameters 
cormdredad 


rasterfilename 


xposttton 


yposition 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Byte array used to supply the name of the partitioned raster image file created 
with the PCONVERTFIGURE intrinsic. This array can be up to 35 characters to 
aliow for a fully qualified MPE filename. It must be terminated by a blank, an 
EOS, or the 35th character, except in BASIC. 


Real variable used to supply the x-coordinate of the upper left corner of the 
raster image on the current logical page. The coordinate is measured in the 
units specified in the units parameter and is either relative or absolute as 
specified in the positionmode parameter. With absolute positioning, only 
positive values are allowed. With relative positioning, a positive value moves 
the image to the right; a negative value moves it to the left. For COBOL, the 
value is passed as an ASCII string. 


Real variable used to supply the y-coordinate of the upper left corner of the 
raster image on the current logical page. The coordinate is measured in the 
units specified in the units parameter and is either relative or absolute as 
specified in the positionmode parameter. With absolute positioning, only 
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positive values are allowed. With relative positioning, a positive value moves 
the image down; a negative value moves it up. For COBOL, the value is passed 
as an ASCII string. 


For more information on positioning, refer to Section 2 on Terminology. 


units Integer variable used to supply the units of measurement for the x- and 
yposttion parameters. units must have a value of 0, 1, 2 or 3. 


0 = Dots 
1 = Inches 
2 = Centimeters 
3 = Millimeters 
positionmode Integer variable used to specify whether the x- and y-coordinates are relative 


or absolute. The relative option positions the partitioned raster image relative 
to the current pen location on the logical page; the absolute option positions the 
image at the absolute location on the logical page. 


0 
1 


Relative 
Absolute 


Discussion 


PFLASHRASTER combines the effects of PLOADRASTER, PPRINTRASTER and PDELETERASTER to load, print 
and delete a partitioned raster image. Since PFLASHRASTER uses temporary raster images, and each image is 
referenced only once in a job, this intrinsic makes it possible to print up to 64 images on a physical page. 
Remember, however, that 64 is an absolute maximum and the actual number is affected by the size of the 
raster images. 


For the raster filename, the MPE temporary file domain is searched first, followed by the permanent file 
domain. 
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By allowing you to specify the exact location of the partitioned raster image, PFLASHRASTER gives you 
complete control over its placement on the logical page. The image can be positioned relative to the current 
location of the pen, or at an absolute location on the logical page. - 


The values of the x- and y-coordinates depend on the size of the current logical page. For absolute 
positioning, only positive values can be used. The value for x moves the image to the right, the value for y 
moves it down. For relative positioning, negative values can be used to move the image left and up, for x and 
¥y respectively. 


x- and yposttton are checked to insure that they lie within the boundaries of the logical page, but no 
checking is done to verify that the entire image fits on the physical page. 


The position of the Laser Printer "pen" is unaffected by printing a partitioned raster image. This means that 
the pen remains where it was prior to printing the image and does not move to a new location. 


Example 


COBOL ITI: DATA DIVISION. 


01 rasterfilename pic X(35). 
01 xposition pic X(16). 
Ol yposition pic X(16). 
Ol units pic S9(4) comp. 
01 positionmode pic S9(4) comp. 


PROCEDURE DIVISION. 


CALL INTRINSIC "PFLASHRASTERA" USING comarea , 
rasterfilename, 
xpostition, 
yposition, 
units, 
positionmode. 


BASIC: 300 CALL PFLASHRASTER (C1[*],R1$,X,Y,U,P) 


Jan 84 
5-43 


PFLASHRASTER[A] 


FORTRAN: CALL PFLASHRASTER (comarea,rasterfilename ,xposition,yposition, 
& units ,positionmode) 
SPL: PFLASHRASTER (comarea,rasterfilename ,xposition,yposition,untits, 
posittionmode) ; 
PASCAL: PFLASHRASTER (comarea,rasterfilename ,xzposition,yposition ,untts, 
positionmode) ; 
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Returns information about a particular character font in the environment. 


Syntax 


LA I BA LA 
PFONTINFO (comarea,fontnumber ,fontname,fontinformation) 


in/out in out out 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

fontnumber Integer variable used to supply the number of the character font. Character 
font number must have a value between 0 and 31, inclusive. 

fontname Byte array in which the name of the character font is returned. This array 
must be 16 bytes long. 

fontinformation Logical array in which information about the character font is returned. This 


array must be at least 30 words long. Its contents are: 
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Discussion 





CONTENTS 


ORIENTATION (0,90,180,270) 


HEIGHT IN DOTS 

CELL WIDTH IN DOTS 

(MAXIMUM WIDTH FOR 
PROPORTIONAL SPACING 
BASELINE (1=BOTTOM OF CELL) 
EXTRA CHARACTER SPACING 
EXTRA LINE SPACING 


PROPORTIONAL SPACING 
INDICATOR: O=NO, -1*=YES 


Reserved for future use 


The character font is specified by number in this intrinsic. If necessary, you can use PFONTNUM to get the 


character font number. 


The fontname is returned in upper case and padded with blanks out to 16 bytes. In BASIC, the array is 
returned with its length set to the number of non-blank characters. 


If there is no name assigned to the character font, all blanks are returned in the fontname array in COBOL, 
SPL, FORTRAN and PASCAL. In BASIC, the array is returned with length 0. 
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Example 


COBOL II: 


BASIC: 


FORTRAN : 


SPL: 


PASCAL: 


PFONTINFO 


DATA DIVISION. 


01 fontnumber pic S9(4) comp. 
01 fontname pic X(16). 
Ol fontinformation pic S$9(4) comp 


occurs 30 times. 

PROCEDURE DIVISION. 
CALL INTRINSIC "“PFONTINFO" USING conmarea, 

fontnumber, 

fontname , 

fontinformattion. 
1020 CALL PFONTINFO (C1[*],I,C9$,L1[*]) 
CALL PFONTINFO (comarea,fontnumber, fontname,fontinformation) 


PFONTINFO (comarea, fontnumber , fontname,fontinformation); 


PFONTINFO (comarea,fontnumber ,fontname,fontinformatton) ; 
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Accepts a fontname and returns the corresponding fontnumber, as defined in the environment file. 


Syntax 


LA BA I 
PFONTNUM (comarea,fontname,fontnumber) 


in/out in out 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

fontname Byte array used to supply the name of the character font. This array can be up 
to 20 characters long, beginning with a letter and terminated by a blank, an 
EOS, or the 20th character. In BASIC, the length is determined from the array 
itself. 

fontnumber Integer variable in which the font number is returned. 

Discussion 


If the fontname begins with a blank or an EOS (or its length is 0 in BASIC), the number of the current 
primary character font is returned. 


The fontnumber is used to refer to the character font in the PUSEFONT, PFONTINFO and PSTRINGWIDTH 
intrinsics. 
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Example 


COBOL II: 


BASIC: 


FORTRAN: 


SPL: 


PASCAL: 


PFONTNUM 


DATA DIVISION. 


01 fontname pic X(16). 
01 fontnumber pic S9(4) comp. 


PROCEDURE DIVISION. 

CALL INTRINSIC "PFONTNUM” USING comarea, 
fontname , 
fontnumber. 

500 CALL PFONTNUM (C1[*],N1$,N2) 

CALL PFONTNUM (comarea,fontname ,fontnumber) 


PFONTNUM (comarea, fontname,fontnumber); 


PFONTNUM (comarea,fontname,fontnumber) ; 
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Initializes the comarea, and identifies the programming language used, the system output file number, and 
the output device. 


Syntax 


LA I I I BA 
PINITDEVICE (comarea,arealength,language,filenumber ,out putdevice) 


in/out in in in in 





Parameters 
comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 
arealength Integer variable used to specify how much space in 16 bit words you have 
supplied for the comarea. This must be at least as much space as indicated on 
the IFS/3000 Main Menu for the environment file you are using. 
language Integer variable specifying which programming language you are using. This is 
necessary for byte arrays to be handled properly. Language must have a value 
of 0, 1, 2, 3 or S. 
O = COBOL I, or COBOL II if not using CALL INTRINSIC 
statement 
1 = BASIC 
2 = FORTRAN 
3 = SPL or COBOL II with the CALL INTRINSIC statement, 
or TRANSACT/3000 
5 = PASCAL 
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filenumber Integer variable used to supply the system file number of the output file opened 
for the device class of the device you are using. This file must also be 
associated with an environment file. You can get the system file number as 


follows: 
COBOL: Formal file designator from the SELECT clause. 
BASIC: SFN (BASIC file number) 
FORTRAN: FNUM (FORTRAN file number) 
SPL: The number retured from FOPEN 


PASCAL: FNUM (PASCAL file identifier) 


If the file number is set to -1, this indicates that no spoolfile is open, and only 
the PCONVERTFIGURE and PFIGUREINFO intrinsics can be used. 


outputdevice Byte array used to supply the device name of the output device. This array can 
be up to 7 characters long, and must be terminated with a blank or EOS. In 
BASIC, the length is determined from the array itself. 


Discussion 


PINITDEVICE supplies IFS/3000 with the length of the comarea, the language you are using, and the output 
file number in the same way as PINITIALIZE. The difference is that PINITDEVICE also specifies the output 
device and allows you to set the file number to -1 which indicates that you do not require an open spoolfile. 
Without an open spoolfile, you cannot use any of the intrinsics that produce printed output. However, you 
can access the PCONVERTFIGURE and PFIGUREINFO intrinsics. 


Depending on your requirements, you should call either PINITIALIZE or PINITDEVICE once before calling 
any other intrinsic. Refer to the discussion of PINITIALIZE in this section. 


Example 


COBOL II: ENVIRONMENT DIVISION. 
CONFIGURATION SECTION. 
INPUT-OUTPUT SECTION. 
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BASIC: 


FORTRAN: 
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FILE-CONTROL. 
SELECT OUT ASSIGN TO "OUTPUT". 

DATA DIVISION. 

File Section. 

FD PrintFile 

label records are omitted. 

01 PrintFileRec pic X(132). 

WORKING-STORAGE SECTION. 

77 language. pic $9(4) comp 
value 3. 

77 comarealength pic S9(4) comp 
value 5000. 

7? outputdevice pic X(7) 


value "2680A ". 


PROCEDURE DIVISION. 


CALL 


790 
800 
810 
820 
830 
840 
850 


INTRINSIC "“PINITDEVICE" USING comarea, 
comarealength, 
language , 
PrintFile, 
out putdevice. 


REM Get the system file number for the file to which 
REM we assigned the number ‘“1" and set the language to 
REM 1 (BASIC) 

A=5000,L=1,F=SFN(1),0$="2680A " 

REM Initialize the comarea 

REM 

CALL PINITDEVICE (C1[*],A,L,F,0$) 


Integer comarealength, language, filenumber 
character *7 outputdevice 
comarealength=5000 

Language=2 


SPL: 


PASCAL: 


PINITDEVICE 


FileNum=FOPEN(OutputFile, ...) 

outputdevice="2680A " 

CALL PINITDEVICE (comarea ,comarealength ,language,filenumber, 
out putdevice) 


Integer comarealength,language,filenumber; 

Byte Array outputdevice; 

comarealength:=5000; 

Language: =3; 

filenumber:=FOPEN(OutputFile, ...); 

out putdevice:="2680A " 

PINITDEVICE (comarea ,comarealength ,language,filenumber ,outputdevice) ; 


type SmallInteger = -32768..32767; 

var 
comarealength ,language,filenumber: SmallInteger; 
outputdevice: packed array [1..7] of char; 


comarealength:=5000; 

language:=5; 

filenumber:=FOPEN(OutputFile, ...); 

outputdevice:="2680A "; 

PINITDEVICE (comarea,comarealength,language,filenumber ,outputdevice) ; 
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Initializes the comarea, and identifies the programming language being used, along with the system file 


number of the output file. 


Syntax 


LA I I I 


PINITIALIZE (comarea,arealength,language,filenumber) 
infout in in in 





Parameters 


comarea 


arealength 


language 


filenumber 
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Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Integer variable specifying how much space in 16 bit words you have supplied 
for the comarea. This must be at least as much space as indicated on the 
IFS/3000 Main Menu for the environment file you are using. 


Integer variable specifying which programming language you are using. This is 
necessary for byte arrays to be handled properly. (COBOL passes byte arrays 
with word addresses. BASIC requires a length byte to be set on return.) 
language must have a value of 0, 1, 2, 3 or 5. 


0 = COBOL I, or COBOL II if not using the CALL INTRINSIC statement 
1 = BASIC 

2 = FORTRAN 

3 = SPL or COBOL II with the CALL INTRINSIC statement 

5 = PASCAL 


The system file number of the output file opened for the device class of the 
Laser Printer. This file must also be associated with an environment file. You 


PINITIALIZE 


can get the system file number as follows: 


COBOL: Formal file designator from the SELECT clause 
BASIC; SFN (BASIC file number) 

FORTRAN: FNUM (FORTRAN file number) 

SPL: The number returned from FOPEN 


PASCAL: FNUM (PASCAL file identifier) 


Discussion 


PINITIALIZE or PINITDEVICE must be called once before any other intrinsic is called. Refer to the 
description of PINITDEVICE in this section. 


Each language that uses the IFS/3000 intrinsics calls them with the same parameters which are essentially of 
the same type and size. In order for the intrinsics to adjust to any peculiarities of the calling language, you 
must specify the language of the calling program in PINITIALIZE. 


Example 


COBOL ITI: ENVIRONMENT DIVISION. 
CONFIGURATION SECTION. 
INPUT-OUTPUT SECTION. 
FILE-CONTROL. 

SELECT OUT ASSIGN TO "OUTPUT". 
DATA DIVISION. 
File Section. 
FD PrintFile 
label records are omitted. 


01 PrintFileRec pic X(132). 

WORKING-STORAGE SECTION. 

7? language pic S9(4) comp 
value 3. 

77 comarealength pic S9(4) comp 
value 5000. 


PROCEDURE DIVISION. 
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BASIC: 


FORTRAN: 


SPL: 


PASCAL: 
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CALL INTRINSIC "PINITIALIZE" USING comarea, 
comarealength, 
language, 
PrintFile. 


790 REM Get the system file number for the file to which 
800 REM we assigned the number "1" and set the language to 
810 REM 1 (BASIC) 

820 A=5000,L=1,F=SFN(1) 

830 REM Initialize the comarea 

840 REM 

850 CALL PINITIALIZE (C1[*],A,L,F) 


Integer comarealength, language, filenumber 
comarealength=5000 

language=2 

filenumber=FOPEN(OutputFile, ...) 

CALL PINITIALIZE (comarea,comarealength,language,filenumber) 


Integer comarealength, language, filenumber; 
comarealength:=5000; 

language: =3; 

filenumber:=FOPEN(OutputFile, ...); 

PINITIALIZE (comarea,comarealength,language,filenumber) ; 


type 
SmallInteger = -32768. .32767; 
var 
comarealength,language,filenumber : SmalliInteger; 


comarealength:=5000; 

language:=5; 

filenumber:=FOPEN(OutputFile, ...); 

PINITIALIZE (comarea,comarealength, language, filenumber) ; 


PLOADRASTER 


Loads a partitioned raster image into Laser Printer memory. 


Syntax 


LA BA I 
PLOADRASTER (comarea, filename ,imagenumber) 


+ 


in/out in in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

filename Byte array used to supply the name of the partitioned raster image file created 
with the PCONVERTFIGURE intrinsic. This array can be up to 35 characters to 
allow for a fully qualified MPE filename. It must be terminated by a blank, an 
EOS, or the 35th character, except in BASIC. 

imagenumber Integer variable used to supply an identification number for the partitioned 
raster image. tmagenumber must have a value between 0 and 31, inclusive. 
tmagenumber is used later with the PPRINTRASTER or PDELETERASTER 
intrinsic. 

Discussion 


A maximum of 32 permanent raster images can be loaded into Laser Printer memory. This maximum is 
affected by the size of each image. Very large images occupy more of the printer memory, and the number 
32 is an absolute maximum. For the raster filename, the MPE temporary file domain is searched first 
followed by the permanent file domain. 


> 
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If you call PLOADRASTER a second time and again supply the same partitioned raster image number without 
having deleted the image, the previously loaded image is changed from permanent to temporary. This means 
that it is deleted from Laser Printer memory after it has been printed. All future references to this 
partitioned raster image number will refer to the newly loaded image. 


Example 


COBOL IT: DATA DIVISION. 


01 rasterfilename pic X(35). 
Ol wtmagenumber pic $9(4) comp. 


PROCEDURE DIVISION. 

CALL INTRINSIC “PLOADRASTER' USING comarea, 
rasterfilename, 
imagenumber. 


BASIC: 800 CALL PLOADRASTER (C1[*],R1$,11) 


FORTRAN: CALL PLOADRASTER (comarea,rasterfilename ,imagenumber) 


SPL: PLOADRASTER (comarea,rasterfilename,imagenumber); 
PASCAL: PLOADRASTER (comarea,rasterfilename,imagenumber); 
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PLOGPAGEINFO 


Returns information about a particular logical page. 


Syntax 


LA I LA 
PLOGPAGEINFO (comarea,pagenumber , pageinformation) 


in/out in out 





Parameters - 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

pagenumber Integer variable used to supply the number of the logical page. pagenumber 
must have a value between 0 and 31 inclusive. To specify the current logical 
page, you can use -1 for this parameter. 

pageinformation Logical array used to return information about the indicated logical page. 


pagetnformation requires a minimum of 30 words. The contents of this 
array are presented in Figure 5-8 on the next page. 
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| worD | MEANING 


0 ORIENTATION (0, 90, 180, 270) 





1 LOGICAL HEIGHT (in dots) 

2 | LOGICAL WIDTH (in dots) 

3 | DISTANCE FROM LEFT TO EDGE OF PAPER (in dots) 
4 DISTANCE FROM TOP TO EDGE OF PAPER (in dots) 
5 | LEFT MARGIN (in dots) 

6 | ACTIVE? 0 = NO, -1 = YES 

7 DOES THIS PAGE HAVE A VFC? 0 = NO, -1 = YES 
8 | HORIZONTAL CHARACTER SPACING (in dots) 

9 VERTICAL LINE SPACING (in dots) 

10 | BASELINE OF BASE CHARACTER FONT (in dots) 

il IF NO VFC: TOP MARGIN (in dots) 

12 Fractional Character Spacing (0,1,2,3) 

13 | Fractional Line Spacing (0,1,2,3) 


14-29 RESERVED FOR SYSTEM USE 


The value -1 is equivalent to the octal %177777. 


Figure 5-8. Contents of pageinformation Array 
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Discussion 


PLOGPAGEINFO 


You specify vertical line spacing using the Logical Page Menu. Your specifications may result in line spacing 
that is a fractional number of dots between lines. In the case of a fractional dot line spacing, the HP Laser 
Printer provides spacing that on the average equals the value specified in the Logical Page Menu. 


In addition to vertical spacing, the horizontal spacing between characters may also be fractions of a dot. For 
horizontal character spacing, PLOGPAGEINFO returns the integer value in word 8 and the fractional value in 
word 12. For vertical spacing, PLOGPAGEINFO returns the integer value in word 9 and the fractional value in 
word 13. The valid values for the fractional values are 0, 1, 2, and 3 representing 0/4, 1/4, 2/4, and 3/4 of a 


dot. 


Exampie 


COBOL II: 


BASIC: 
FORTRAN: 
SPL: 


PASCAL: 


DATA DIVISION. 

01 pagenumber pic S9(4) comp. 

01 pageinformation pic S9(4) comp 
occurs 30 times. 

PROCEDURE DIVISION. 

CALL INTRINSIC "“PLOGPAGEINFO" USING comarea, 
pagenumber , 
pageinformation. 

450 CALL PLOGPAGEINFO (C1[*],L1,L2[*]) 

CALL PLOGPAGEINFO (comarea,pagenumber ,pageinformation) 

PLOGPAGEINFO (comarea,pagenumber ,pageinformation); 

PLOGPAGEINFO (comarea,pagenumber ,pageinformation) ; 
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PMOVEPENABS 


Moves the Laser Printer "pen" 


Syntax 


LA 
PMOVEPENABS (coma 


in/o 


relative to the upper left hand corner of the logical page. 


I I 
rea ,x,y) 
ut in in 





Parameters 


comarea 


Discussion 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Integer variable which supplies the x-coordinate of the position on the logical 
page to which you want to move the Laser Printer pen. x is expressed in dots 
relative to the left edge of the logical page, where the logical page is viewed in 
the direction of its orientation. The value must be greater than or equal to 
Zero. 


Integer variable used to supply the y-coordinate of the position on the logical 
page to which you want to move the Laser Printer pen. y is expressed in dots 
relative to the top edge of the logical page, where the logical page is viewed in 
the direction of its orientation. The value must be greater than or equal to 
Zero. 


It is helpful to visualize that the Laser Printer writes with an imaginary "pen". When determining where you 
want to move the pen, be sure to view the logical page in the direction of its orientation, as specified on the 


IFS/3000 Logical Page Menu. 
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Then visualize a coordinate system with the origin in the upper left corner of 


PMOVEPENABS 


the logical page. To identify where you want to move the pen, specify the x and y coordinates in number of 
dots using positive integers. This new pen location is where the character cell left edge/baseline will start. 


Example 


COBOL II: 


BASIC: 
FORTRAN: 
SPL: 


PASCAL: 


DATA DIVISION. 


01 «x pic $9(4) comp. 
Ol y pic S9(4) comp. 


PROCEDURE DIVISION. 

CALL INTRINSIC "“PMOVEPENABS" USING comarea, 
xy 
y. 

650 CALL PMOVEPENABS (C1[*],X,Y) 

CALL PMOVEPENABS (comarea,x,y) 

PMOVEPENABS (comarea,x,y); 


PMOVEPENABS (comarea,x,y); 
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Moves the Laser Printer "pen" relative to its current position. 


Syntax 


LA 


I I 


PMOVEPENREL (comarea,x,y) 


infout in in 





Parameters 


conarea 


Discussion 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Integer variable used to supply the x-coordinate of the position on the logical 
page to which you want to move the Laser Printer pen. x is expressed in dots 
relative to the pen’s current position on the logical page, where the logical page 
is viewed in the direction of its orientation. Positive values move the pen to 
the right; negative values move the pen to the left. 


Integer variable used to supply the y-coordinate of the position on the logical 
page to which you want to move the Laser Printer pen. y is expressed in dots 
relative to the pen’s current position on the logical page, where the logical page 
is viewed in the direction of its orientation. Positive values move the pen 
down; negative values move the pen up. 


PMOVEPENREL is similar to PMOVEPENABS except that PMOVEPENREL moves the pen relative to its current 
position. Also, PMOVEPENREL allows you to enter negative as well as positive values for x- and y-coordinates. 
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Positive values move the pen to the right and down for x and y respectively; negative values move it left and 
up. Refer to the discussion of PMOVEPENABS. 


Example 
COBOL IT: DATA DIVISION. 
01 2 pic S9(4) comp. 
Ol y pic S9(4) comp. 
PROCEDURE DIVISION. 
CALL INTRINSIC "PMOVEPENREL" USING comarea, 
Zs 
y. 
BASIC: 650 CALL PMOVEPENREL (C1[*],xX,Y) 
FORTRAN: CALL PMOVEPENREL (comarea,x,y) 
SPL: PMOVEPENREL (comarea,x,y); 
PASCAL: PMOVEPENREL (comarea,x,y); 
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PNEWFORM 


Selects the form you want to write to. 


Syntax 


LA BA 
PNEWFORM (comarea, formname) 


in/out in 





Parameters 

COMATea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

formname Byte array used to supply the name of the form you want to write to. The 

form must be on the current logical page. formname can be up to 16 

characters long beginning with a letter and terminated by a blank, an EOS, or 
the 16th character. In BASIC, the length is determined from the array itself. 
It is the name assigned to the form when it was designed in IDSFORM. 

Discussion 


This intrinsic is used only when there is more than one form on the current logical page. You use PNEWFORM 
to select which of the forms you want to write to. 


You may not have to call PNEWFORM if you have called PNEWPHYSPAGE or PNEWPAGE. If there is a form on 
the current logical page, PREWPHYSPAGE and PNEWPAGE automatically make it the current form. 


You can also use the special values "1" and "2" for the formname to specify either form 1 or form 2 on the 
logical page. Forms | and 2 are specified on the Logical Page Forms Menu in IFS/3000. If you want to get 
the names of the forms, you can use PSTATEINFO. 
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Multi-copy forms can be accessed using PNEWFORM. A multi-copy form is made current automatically if it is 
the only form on the current logical page. 


Exampie 


COBOL II: 


BASIC: 
FORTRAN: 
SPL: 


PASCAL: 


DATA DIVISION. 
01 formname pic X(16). 
PROCEDURE DIVISION. 


CALL INTRINSIC "“PNEWFORM" USING comarea, 
formname . 


350 CALL PNEWFORM (C1[*],F1$) 
CALL PNEWFORM (comarea, formname) 
PNEWFORM (comarea,formname); 


PNEWFORM (comarea,formname); 
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PNEWPAGE 


Advances to the next active logical page. 


Syntax 


LA 
PNEWPAGE (comarea) 


in/out 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

Discussion 


PNEWPAGE is used to advance to the next active logical page. If you are already on the last logical page, 
PNEWPAGE causes a physical page eject and takes you to the first active logical page again. The pages are 
cycled through in order of the logical page number as assigned in IFS/3000. 


When you call PNEWPAGE, it keeps track of which logical page you are printing and passes that information to 
other intrinsics for error checking and forms control. For example, if you call PNEWPAGE followed by 
PNEWFORM, PNEWFORM verifies that the form you want to print is on the current logical page. If it is not, 
PNEWFORM issues an error message. Also, PNEWPAGE automatically makes the first form on the active logical 
page the current form. This usually eliminates the need to call PNEWFORM since the first form is the first 
form you normally want to write to. PNEWPAGE also prints any forms on an active logical page before 
advancing to the next physical page. 


If only one form is accessible from the logical page, it is made the current form. If multiple forms are 


accessible, PNEWFORM selects form 1. 
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If no forms exist on the logical page, and this is the page to be used with multi-copy forms, the first form for 
the first copy in the multi-copy form table is selected. If there is no form for the first copy, PNEWPAGE looks 
for a form in each successive copy until a form is found or until it reaches the last copy. 


Example 
COBOL II: DATA DIVISION. 
PROCEDURE DIVISION. 
CALL INTRINSIC "“PNEWPAGE" USING comarea. 
BASIC: 220 CALL PNEWPAGE (C1[*]) 
FORTRAN: CALL PNEWPAGE (comarea) 
SPL: PNEWPAGE (comarea); 
PASCAL: PNEWPAGE (comarea); 
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Advances to the next physical page. 


Syntax 


La 
PNEWPHYSPAGE (comarea) 


in/out 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

Discussion 


PNEWPHYSPAGE advances to the next physical page and prints the first active logical page. 


PNEWPHYSPAGE determines the current form using the same method as PNEWPAGE. If only one form is 
accessible from the logical page, it is made the current form. If multiple forms are accessible, PREWPHYSPAGE 
selects form | if it is on this logical page; otherwise, form 2 is selected. 


If no forms exist on the logical page, and this is the page to be used with multi-copy forms, the first form for 
the first copy in the multi-copy form table is selected. If there is no form for the first copy, PREWPHYSPAGE 
looks for a form in each successive copy until a form is found or until it reaches the last copy. 
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Example 


COBOL II: 


BASIC: 


FORTRAN: 


SPL: 


PASCAL: 


DATA DIVISION. 


PROCEDURE DIVISION. 


CALL INTRINSIC “PNEWPHYSPAGE" USING comarea. 


220 CALL PNEWPHYSPAGE (Ci[*]) 
CALL PNEWPHYSPAGE (comarea) 
PNEWPHYSPAGE (comarea); 


PNEWPHYSPAGE (comarea); 


PNEWPHYSPAGE 
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PNEWSUBFORM 


Selects the current subform you want to write to. 


Syntax 


LA BA 
PNEWSUBFORM (comarea,subformam:) 


in/out in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

subformname Byte array used to supply the name of the current subform you want to write 
to. This array can be up to 16 characters long, and must be terminated by a 
blank, an EOS, or the 16th character. In BASIC, the length is determined from 
the array itself. 

Discussion 


PNEWSUBFORM is optional when you are writing data into a form containing multiple subforms, but is required 
when you are writing data into a form containing duplicate field names. 


When you write data programmatically into a form with the PWRITEFIELD intrinsic, you must provide the 
name of the field you want to write to. PNEWSUBFORM directs PWRITEFIELD to the appropriate subform 
when duplicate field names exist. 


For a form with many subforms, using PNEWSUBFORM can result in a performance improvement since it 


restricts the fields searched to those within a particular subform only. An exception to this is when the 
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subform name begins with a blank or EOS or has length zero in BASIC. In this case, all the fields in the 
entire form are searched for the fieldname you indicated in PWRITEFIELD. 


Fields are always defined within subforms. You can have duplicate field names within the same form, as long 
as the fields are not in the same subform. When the same name is used for more than one field in a form, you 
must call PNEWSUBFORM first to identify which subform contains the field, and then call PWRITEFIELD to 
write to the field. Since the field names are stored in no particular order, PWRITEFIELD uses the first field it 
encounters with that name unless you identify the appropriate subform. 


Example 
COBOL II: DATA DIVISION. 
01 subformname pic X(16). 
PROCEDURE DIVISION. 
CALL "“PNEWSUBFORM" USING comarea, 
subformname . 
BASIC: 210 CALL PNEWSUBFORM (C1[*],S1$) 
FORTRAN: CALL PNEWSUBFORM (comarea,subformname) 
SPL: PNEWSUBFORM (comarea,subformname) ; 
PASCAL: PNEWSUBFORM (comarea,subformname) ; 
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PPRINTFIGURE[A] 


Converts a figure in a figure file to a partitioned raster image file, then prints the partitioned raster image. 
The ASCII version, callable from COBOL, is denoted by an "A" after the intrinsic name. 


Syntax 


LA BA BA BA 
PPRINTFIGURE (comarea,figurefilename,figurename ,rasterfilename, 
in/out in in in 


R I I R R 
imageheight ,units,imagerotation,xposition,yposition, 
in in in in in 


I I 
posittonmode ,rasterimaget ype) 
in in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

figurefilename Byte array used to supply the name of the figure file that contains the figure 
you want to convert. This array can be up to 35 characters long to allow for a 
fully qualified MPE filename. If the filename is less than 35 characters, it 
must be terminated by a blank or an EOS. In BASIC a blank or EOS is not 
necessary since the length is determined from the array itself. 

figurename Byte array used to supply the name of the figure within the specified figure 
file that you want to convert. This array can be up to 16 characters (upper or 
lower case) beginning with a letter, and cannot include any embedded blanks. 
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rasterfilename 


itmageheight 


units 


tmagerotation 


xposition 


PPRINTFIGURE[A] 


If the fzgurename is less than 16 characters, it must be terminated by a blank 
or an EOS. In BASIC a blank or EOS is not necessary since the length is 
determined from the array itself. 


Byte array used to supply the name of the partitioned raster file that will 
contain the converted figure. This array can be up to 35 characters to allow 
for a fully qualified MPE file name. It must be terminated by a blank, an EOS, 
or the 35th character, except in BASIC. This parameter is optional; if it is not 
used, you must leave at least one blank in this position. The figure is then 
converted to a temporary partitioned raster file called OUT2680A or 
OUT 2688A. 


Real number used to supply the height of the partitioned raster image, viewed 
in the direction of its orientation, and given in the units specified in the units 
parameter. The width of the partitioned raster image is automatically 
calculated from the height. For COBOL, the value is passed as an ASCII string. 
One dot is added to the imageheight when it is converted; that is, a specified 
height of 300 dots creates an image 301 dots high. You only need to take this 
into account if you are working with extremely precise dot measurements. 


Integer specifying the unit of measurement to be used for the tmageheight. 
untts must have a value of 0, 1, 2 or 3. 


0 = Dots 

1 = Inches 

2 = Centimeters 
3 = Millimeters 


Integer variable used to supply the orientation for the partitioned raster image 
with respect to the logical page. imagerotation must have a value of 0, 90, 
180 or 270. For more information, refer to Section 2 on Terminology. Also 
refer to Figure 5-9 in the Examples of this intrinsic. 


Real variable used to supply the x-coordinate of the upper left corner of the 
raster image on the current logical page. The coordinate is measured in the 
units specified in the units parameter and is either relative or absolute as 
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PPRINTFIGURE[A] 


yposttion 


posittonmode 


rasterimagetype 
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specified in the postttonmode parameter. With absolute positioning, only 
positive values can be used. With relative positioning, a positive value moves 
the image to the right; a negative value moves it to the left. For COBOL, the 
value is passed as an ASCII string. 


Real variable used to supply the y-coordinate of the upper left corner of the 
raster image on the current logical page. The coordinate is measured in the 
units specified in the units parameter and is either relative or absolute as 
specified in the posttionmode parameter. With absolute positioning, only 
positive values can be used. With relative positioning, a positive value moves 
the image down; a negative value moves it up. For COBOL, the value is passed 
as an ASCII string. 


For more information on positioning, refer to Section 2 on Terminology and 
Figure 5-9 in the Examples of this intrinsic. 


Integer variable used to specify whether the x- and y-coordinates are relative 
or absolute. The relative option positions the image relative to the current pen 
location on the logical page; the absolute option positions the image at the 
absolute location on the current page. posttionmode mode must have a value 
of Oor 1. 


Relative 
Absolute 


0 
1 


Integer variable used to specify whether the image is permanent or temporary. 
rasterimagetype must have a value of 0 or 1. 


0 
1 


Temporary 
Permanent 


A temporary partitioned raster image is deleted immediately after printing; a 
permanent image remains in Laser Printer memory for future use. 


PPRINTFIGURE[A] 


Discussion 





PPRINTFIGURE allows you to specify the partitioned raster image to be printed in one of two ways: either 
with or without the partitioned raster filename as a parameter. 


if you use the partitioned raster filename, the partitioned raster image can be printed directly. PPRINTFIGURE 

compares the rotation, size and creation date of the partitioned raster image with those of the figure in the 
figure file. If the rotation or size do not match or if the figure date is more recent than the partitioned raster 
image date, a new raster image file is created. This new raster image file replaces the file you specified and is 
given the same name. Specifying an existing raster filename can save time and system resources since there is 
no need to reconvert a figure that has not been changed. 


If you do not specify a partitioned raster filename, PPRINTFIGURE converts the figure to a partitioned raster 
image file, prints the image, and places it in a temporary file. 


PPRINTFIGURE also deletes raster images from Laser Printer memory on a least recently used basis. This 
occurs when there is not enough space to load another image into Laser Printer memory. 


Example 


COBOL II: DATA DIVISION. 


01 figurefilename pic X(35). 
01 figurename pic X(16). 
01 rasterfilename pic X(35). 
Ol <imageheight pic X(16). 
01 units pic S9(4) comp. 
Ol imagerotation pic S9(4) comp. 
01 xposition pic X(16). 
01 yposition pic X(16). 
01 positionmode pic S9(4) comp. 
Ol wtmagetyupe pic S9(4) comp. 


PROCEDURE DIVISION. 
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CALL INTRINSIC "PPRINTFIGUREA" USING comarea, 
figurefilename, 
figurename , 
rasterfilename, 
imageheight , 
units, 
tmagerotatton , 
xpostition, 
yposition, 
posit tonmode , 
tmagetype. 


BASIC: S500 CALL PPRINTFIGURE (C1[{*],F1$,N1$,R1$,H,U,R,X,Y,M,T) 


FORTRAN: CALL PPRINTFIGURE (comarea,figurefilename,figurename,rasterfilename, 
& imagehetght ,units,imagerotation ,xposition,yposition, 
& positionmode ,imaget ype) 


SPL: PPRINTFIGURE (comarea,figurefilename,figurename ,rasterfilename , 
emageheight ,units,imagerotation ,xposition,yposition, 
posttionmode ,imagetype); 


PASCAL: PPRINTFIGURE (comarea,figurefilename ,figurename ,rasterfilename, 
tnageheight ,units,imagerotation ,xposition,yposition, 
postittonmode ,imagetype); 
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Figure 5-9 shows figures printed at 0 and 90 degree rotations on different logical page orientations with the 
PPRINTFIGURE intrinsic. The logical page dimensions are 10 x 7 inches and the figure is 5 inches high. The 
rotation of the figure is specified with respect to the logical page. 


2680A 2688A 
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Figure 5-9. Figures printed with the PPRINTFIGURE intrinsic 
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PPRINTRASTER[A] 


Prints a partitioned raster image which has been loaded into Laser Printer memory. The ASCII version, 
callable from COBOL, is denoted by an "A" after the intrinsic name. 


Syntax 


LA I R R I I 
PPRINTRASTER (comarea,imagenumber ,xposition,yposition ,units,positionmode) 


\ 


e 


in/out in in in in in 





Parameters 


comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


imagenumber Integer variable used to supply the number of the partitioned raster image to be 
printed, as specified in the PLOADRASTER intrinsic. imagenumber must have a 
value between 0 and 31 inclusive. 


xposition Real variable used to supply the x-coordinate of the upper left corner of the 
raster image on the current logical page. The coordinate is measured in the 
units specified in the units parameter and is either relative or absolute as 
specified in the posittonmode parameter. With absolute positioning, only 
positive values can be used. With relative positioning, a positive value moves 
the image to the right; a negative value moves it to the left. For COBOL, the 
value is passed as an ASCII string. 


yposittion Real variable used to supply the y-coordinate of the upper left corner of the 
raster image on the current logical page. The coordinate is measured in the 
units specified in the wnits parameter and is either relative or absolute as 
specified in the posittonmode parameter. With absolute positioning, only 
positive values can be used. With relative positioning, a positive value moves 
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units 


positionmode 


Discussion 


PPRINTRASTER[A] 


the image down; a negative value moves it up. For COBOL, the value is passed 
as an ASCII string. 


For more information on positioning, refer to Section 2 on Terminology and to 
Figure 5-10 in the Examples of this intrinsic. 


Integer variable used to supply the units of measurement for the x- and 
yposition parameters. units must have a value of 0, 1, 2 or 3. 


0 = Dot's 

1 = Inches 

2 = Centimeters 
3 = Millimeters 


Integer variable used to specify whether the x- and y-coordinates are relative 
or absolute. The relative option positions the image relative to the current pen 
location on the logical page; the absolute option positions the image at the 
absolute location on the current page. positionmode must have a value must 
be O or I. 


0 
1 


Relative 
Absolute 


PPRINTRASTER prints a partitioned raster image on the Laser Printer. The image must already have been 
loaded with the PLOADRASTER intrinsic. 


By allowing you to specify the exact location of the partitioned raster image, PPRINTRASTER gives you 
complete control over its placement on the logical page. The image can be positioned relative to the current 
location of the pen, or at an absolute location on the logical page. 


The values of the x- and y-coordinates depend on the size of the current logical page. For absolute 
positioning, only positive values can be used for x and y. The value for x moves the image to the right, the 
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value for y moves it down. For relative positioning, negative values can be used to move the image left and 
up, for x and y respectively. 


xX and Y positions are checked to insure that they lie within the boundaries of the logical page, but no 
checking is done to verify that the entire image fits on the physical page. 


The position of the Laser Printer "pen" is unaffected by printing a partitioned raster image. This means that 
the pen remains where it was prior to printing the image and does not move to a new location. 


Example 


COBOL II: DATA DIVISION. 


01 Figure-Number pic $9(4) comp. 
Ol xposition pic X(16). 
Ol yposition pic X(16). 
01 units pic $9(4) comp. 
01 positionmode pic S9(4) comp. 


PROCEDURE DIVISION. 


CALL INTRINSIC "PPRINTRASTERA" USING comarea, 


imagenumber , 
xposition, 
yposition, 
units, 
postttonmode. 
BASIC: 900 CALL PPRINTRASTER (C1[*],11,X,Y,U,P) 
FORTRAN: CALL PPRINTRASTER (comarea,imagenumber ,xpositton ,yposition,units, 
& postttonmode) 
SPL: PPRINTRASTER (comarea,imagenumber ,xposition ,yposition ,units, 
posttionmode) ; 


Jan 84 
5-82 


PPRINTRASTER[A] 


PASCAL: PPRINTRASTER (comarea,imagenumber ,xposition,yposition ,units, 
positionmode); 


Figure 5-10 shows partitioned raster images printed at 0 and 90 degree rotations on different logical page 
orientations with the PPRINTRASTER intrinsic. The logical page dimensions are 10 x 7 inches and the raster 
image is 5 inches high. The rotation of the image was assigned with the PCONVERTFIGURE intrinsic and is 


specified with respect to the physical page. 
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X=90 X=90 









0 Degree 
Rotation 





0 Degree 
Rotation 






0 Degree 
Rotation 






0 Degree 
Rotation 












LANDSCAPE 





LANDSCAPE 






X=1890 
Y=900 


X=1890 
Y¥=900 





PORTRAIT 


uole}OY 
90169q 06 
UoleBIoYy 
90168q 06 





PORTRAIT 


uoIe}OY 
aas69q 06 


X=2400 
Y=2250 





X=2400 
Y=2250 





uoneioy 
aasbegq 06 





bh ORIGIN 


Figure 5-10. Figures printed with the PPRINTRASTER intrinsic 


Jan 84 
5-83 


PSELECTPAGE 


Activates and advances to the selected logical page. Optionally performs a physical page eject. 


Syntax 


LA I I 
PSELECTPAGE (comarea,logicalpagenumber ,ejectoption) 


infout in in 





Parameters 


comarea 


Logical pagenumber 


ejectoption 


Discussion 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Integer variable used to supply the number of the logical page you want to 
activate and print. logicalpagenumber must have a value between 0 and 
31. 


Integer variable used to specify an optional physical page eject, where 0 = no 
physical page eject and 1 = physical page eject. 


The Laser Printer manages logical pages by number and determines which page to print next by cycling 
through the logical page numbers of active logical pages. PSELECTPAGE enables you to activate any logical 
page in the environment, in any order. The logical page selected remains activated and will then print in 
numerical order as the Laser Printer continues cycling through the active logical pages. Using the physical 
page eject option allows printing of one logical page per physical page even though other logical pages are 


active. 
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Example 


COBOL II: 


BASIC: 


FORTRAN: 


SPL: 


PASCAL: 


PSELECTPAGE 


DATA DIVISION. 


01 Llogicalpagenumber pic S$9(4) comp. 
Ol ejectoption pic S9(4) comp. 


PROCEDURE DIVISION. 
CALL INTRINSIC "PSELECTPAGE” USING comarea, 
Logical pagenumber , 
ejectoption. 
400 CALL PSELECTPAGE (C1[*],L1,£1) 
CALL PSELECTPAGE (comarea,logicalpagenumber ,ejectoption) 
PSELECTPAGE (comarea,logical pagenumber ,ejectoption) ; 


PSELECTPAGE (comarea,logicalpagenumber ,ejectoption) ; 
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PSTATEINFO 


Returns information about the current state of the print job. 


Syntax 


LA 


BA BA LA 


PSTATEINFO (comarea,formname,subformname,stateinformation) 


in/o 


ut out out out 





Parameters 


COMArEa 


formname 


subformname 


statetnformation 
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Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Byte array used to return the name of the current form on the current logical 
page. This array must be at least 16 characters long. The form name is 
returned with all letters in upper case and with blanks padded out to 16 bytes. 
In BASIC, the array is returned with its length set to the number of nonblank 
characters in the form name. If there is no form name, all blanks are returned 
in COBOL, SPL, FORTRAN and PASCAL, and in BASIC a length of zero is 
returned. 


Byte array used to return the name of the current subform in the current 
form. This array must be at least 16 characters long. The subform name is 
returned with all letters in upper case and with blanks padded out to 16 bytes. 
In BASIC, the array is returned with its length set to the number of nonblank 
characters in the subform name. If there is no subform name, all blanks are 
returned in COBOL, SPL, FORTRAN and PASCAL, and in BASIC a length of 
zero is returned. 


Logical array used to return information about the current state of the print 
job. This array must be at least 30 words long. The contents of this array are: 


PSTATEINFO 


WORD CONTENTS 


CURRENT LOGICAL PAGE NUMBER 





CURRENT PRIMARY CHARACTER FONT NUMBER 
CURRENT SECONDARY CHARACTER FONT NUMBER 
PHYSICAL PAGE WIDTH IN DOTS (as defined in IFS/3000) 


PHYSICAL PAGE LENGTH IN DOTS (as defined in IFS/3000) 


RESERVED FOR SYSTEM USE 


Figure 5-11. Contents of stateinformation Array 


Discussion 


The physical page dimensions returned in words 3 and 4 of the stateinformation parameter are those you 
defined with the IFS/3000 Physical Page Menu. If the wrong size paper is loaded in the Laser Printer and 
the printer did not detect the error, PSTATEINFO does not detect the error either. The physical page length is 
measured in the direction of paper motion. The physical page dimensions are included so that an intelligent 
text processing system can determine the apparent margins created when using logical pages which are smaller 
than the paper. 


Example 
COBOL II: DATA DIVISION. 
Ol formname pic X(16). 
01 subformname pic X(16). 
01 stateinformation 
03 CurrLogPageNum pic S9(4) comp. 
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PSTATEINFO 


BASIC: 


FORTRAN: 


SPL: 


PASCAL: 
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03 
03 


03 
03 


CurrPriCharNumm 
CurrSecCharNumm 
PhysPageWidth 
PhysPageLength 
Filler 


PROCEDURE DIVISION. 


pic 
pic 
pic 
pic 
pic 


S$9(4) comp. 
S9(4) comp. 
S$9(4) comp. 
$9(4) comp. 
$9(4) comp 


occurs 25 times. 


CALL INTRINSIC "“PSTATEINFO" USING comarea, 


formname , 
subformname , 
stateinformation. 


650 PSTATEINFO (C1[*] ,F1$,S1$,S2[*]) 


CALL PSTATEINFO (comarea,formname,subformname,stateinformation) 


PSTATEINFO (comarea, formame ,subformname,stateinformation) ; 


PSTATEINFO (comarea, formname ,subformname ,stateinformation); 


PSTRINGWIDTH 


Returns the width of a string in number of dots. 


Syntax 


LA I I I 
PSTRINGWIDTH (comarea,fontnumber,string,stringlength,stringwidth) 


in/out in in in out 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

fontnumber Integer variable used to supply the number of the character font used to print 
the string. You can specify the current character font by supplying a value of 
~1 for this parameter. 

string Byte array used to supply the string for which you want to know the printed 
width. 

stringlength Integer variable used to supply the length of the string in number of bytes. 
BASIC requires a dummy variable for this parameter. 

stringwidth Integer variable used to return the width in dots of the string when printed 


using the character font indicated. 
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PSTRINGWIDTH 


Discussion 


The character font you specify must have been defined in IFS/3000. An exception to this is font number 31 
which is the Laser Printer default character font. 


In determining the width of a string, PSTRINGWIDTH counts the width of leading and embedded blanks, but 
ignores trailing blanks. To determine the width of a blank, supply a string with an initial blank and a 
stringlength of 1. 

Example 


COBOL ITI: DATA DIVISION. 


01 fontnumber pic S9(4) comp. 
01 string pic X(72). 

01 stringlength pic S9(4) comp. 
O01 stringwidth pic S9(4) comp. 


PROCEDURE DIVISION. 


CALL INTRINSIC “PSTRINGWIDTH" USING comarea, 


fontnumber, 
string, 
stringlength, 
stringwidth. 
BASIC: 220 CALL PSTRINGWIDTH (C1[*],N1,S1$,L1,W1) 
FORTRAN: CALL PSTRINGWIDTH (comarea,fontnumber ,string,stringlength, 
& stringwidth) 
SPL: PSTRINGWIDTH (comarea, fontnumber,string,stringlength,stringwidth) ; 
PASCAL: PSTRINGWIDTH (comarea,fontnumber ,string,stringlength,stringwidth) ; 
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PUSEFONT 


Selects primary and secondary character fonts. 


Syntax 


LA I I 
PUSEFONT (comarea ,primaryfontnumber ,secondaryfontnumber) 


in/out in in 





Parameters 

comarea Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 

primaryfontnumber Integer variable used to supply the number of the character font you want to 
use as the primary character font. primaryfontnumber must have a value 
between 0 and 31. 

secondaryfontnumber Integer variable used to supply the number of the character font you want to 
use as the secondary character font. secondaryfontnumber must have a 
value between 0 and 31. 

Discussion 


If you specify -1 as the primary- or secondaryfontnumber, the character font currently being used as the 
primary or secondary character font is not changed. 


To determine a font number, you can use PFONTNUM. 
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PUSEFONT 


Example 


COBOL ITI: 


BASIC: 
FORTRAN: 
SPL: 


PASCAL: 
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DATA DIVISION. 


01 primaryfontnumber pic S9(4) comp. 
01 secondaryfontnumber pic S9(4) comp. 


PROCEDURE DIVISION. 

CALL INTRINSIC “PUSEFONT" USING comarea, 
primaryfontnumber , 
secondaryfontnumber. 

350 CALL PUSEFONT (C1[*],P1,S1) 

CALL PUSEFONT (comarea,primaryfontnumber ,secondaryfontnumber) 


PUSEFONT (comarea,primaryfontnumber ,secondaryfontnumber) ; 


PUSEFONT (comarea,primaryfontnumber ,secondaryfontnumber) ; 


PWRITEFIELD 


Writes data to a field or subfield in a form. 


Syntax 


LA BA I BA I 
PWRITEFIELD (comarea,fieldname,subfieldnumber ,data,datalength) 


° 


in/out in in in in 





Parameters 


comarea 


fieldname 


subfieldnumber 


data 


datalength 


Logical array containing information for internal use. The first word returns 
the status of the intrinsic call. 


Byte array used to supply the name of the field you want to write to. The field 
name must have been specified in the form using IDSFORM. The field name 
can be up to 16 characters beginning with a letter and terminated by a blank, 
an EOS or the 16th character. In BASIC the length is determined from the 
array itself. 


Integer indicating which subfield you want to write to. Subfields are 
numbered beginning with 1. The subfield number is edited, and an error 
occurs if the subfield number is greater than the number of subfields in the 
field. Use a value of -1 when the field has only 1 subfield. 


Byte array containing the data you want to write into the field or subfield. 


Integer variable indicating the length in bytes of the array you supplied for the 
data parameter. In BASIC, you can use a dummy variable for this parameter. 
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PWRITEFIELD 


Discussion 


PWRITEFIELD enables you to write one or more lines of data into a single subfield. Lines must be separated 
by a carriage return (ASCII 13) in the data array. If the last line of data is blank, a carriage return is 
required after the last line; otherwise a carriage return after the last line is optional. 


If there are any trailing blanks in the data array, they are stripped from each line of data before it is written 
to the field. Since all lines of data, even blank lines, are counted when centering the data, you may want to 
include blank lines in your array to correctly position the data. 


Data is centered vertically and left-justified horizontaliy in the subfield area. There is some padding 
between the left edge of the subfield and the start of the data. This padding is equal to 1/3 the cell height of 
the character font being used for printing. 


If underlines are specified for any portion of the field, they are placed in fixed positions by IDSFORM. If a 
form is not a print and space form, the printed data is iined up with the underlines rather than centered 
vertically. This means that the height of the IDSFORM graphics grid is used for vertical character spacing, so 
you should be careful that the character font you are using to fill in the form is appropriate for the 
IDSFORM grid spacing. For more information, refer to the IDSFORM Reference Guide (part number 
36581-90002). 


The maximum length of a print line is 250 bytes, but there is no limit to the length of the data array. The 
length of the data array is determined by the value you supply in the datalength parameter. You can use 
trailing blanks or an EOS (character 255) to terminate a data array before the end of the array is reached. 


Example 
COBOL II: DATA DIVISION. 
01 fieldname pic X(16). 
01 subfieldnumber pic S9(4) comp. 
01 FieldDataDescription. 
03 data pic X(80). 
03 FieldDataRedef redefines data. 
05 FieldDataDetail pic X(59). 
05 ReturnChar pic X value 415. 
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BASIC: 


FORTRAN: 


SPL: 


PASCAL: 


05 SecondData 

05 ReturnChar 

0S ThirdData 
01 datalength 


PROCEDURE DIVISION. 


CALL INTRINSIC "PWRITEFIELD" USING 


PWRITEFIELD 


pic X(9). 

pic X value %15. 
pic X(10). 

pic S9(4) comp. 


comarea , 
fieldname , 
subfieldnumber , 
data, 
datalength. 


250 CALL PWRITEFIELD (C1[*],F1$,S,D1$,L) 


CALL PWRITEFIELD (comarea,fieldname,subfieldnumber ,data, 


& datalength) 


PWRITEFIELD (comarea, fieldname,subfieldnumber ,data,datalength) ; 


PWRITEFIELD (comarea, fieldname,subfieldnumber ,data,datalength) ; 
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This section lists the MPE commands and intrinsics that will be useful when operating the HP Laser Printer 
Support Package subsystems. Your environment file and component files are disc files which reside within 
the HP 3000 MPE operating system domain. You can use the following MPE commands and intrinsics to 
associate an environment file with your data file and direct your output to the Laser Printer. In addition, 
you can monitor the status of your print job, verify where files reside, verify a file’s code and type; and copy 
files between groups, account, and systems. 


The commands provide non-programmatic access to the MPE operating system, The intrinsics provide 
programmatic access. For more information, refer to the MPE Commands Reference Manual (part number 
30000-90009) and the MPE Intrinsics Reference Manual (part number 30000-90010). 


MPE Commands 


:FILE You can use the :FILE command to set a file equation specifying the Laser 
Printer as the output target device. With the DEV parameter, most 
installations will use device class PP for the 2680A and PP88 for the 2688A. 
Other device classes can also be used. The equation must also contain an ENV 
‘parameter which specifies an environment file to be used when printing the 
associated data file. The environment file can be one of those supplied by 
Hewlett-Packard and listed in Appendix C, or a custom environment file you 
designed using IFS/3000. 


EDITOR 


:FILE MYFILE;DEV=PP;ENV=PICA.HPENV.SYS 

:EDITOR *MYFILE 

HP32201A.7.12 EDIT/3000 MON. JUL 12, 1982, 11:09 AM 
(C) HEWLETT-PACKARD CO. 1979 

/T PRINTIFS 

FILE UNNUMBERED 

/L ALL,OFFLINE 

¥** OFF LINE LISTING BEGUN. *** 

/EXIT 
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: FCOPY 
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END OF SUBSYSTEM 


For multiple colated copies of output, specify the number of 
ccpies as the third DEV parameter as shown in the following: 


FILE MYFILE;DEV=PP, ,3;;ENV=PICA.HPENV.SYS 


To specify a unique paper size, add the FORMS=FORMSMSG to the 
file equation. FORMSMSG is a string of not more than 49 characters 
terminated with a period. This message will be displayed on the 
console and must be verified by the operator before the user can 
access the file. 


You can use the :FCOPY command to copy an environment file or component 
file from one group and account to another. You specify the :FCOPY command 
within the group and account where you want the copied file to reside. You 
must have previously released the file you wish to copy in the group and 
account where it resides or MPE security will not allow :FCOPY access to the 
file. 


You can also use :FCOPY to copy a file to a specific device and a specific 
environment. 


FCOPY 

>FILE FILEOUT ; DEV=PP88 ; ENV=LP88.HPENV.SYS 

> FCOPY 

HP32212A. 3.15 FILE COPIER (C) HEWLETT-PACKARD CO. 1982 


>FROM=PRINTIFS;TO=*FILEOUT 

*200*WARNING:FROMFILE RECSIZE IS 72BYTES,TOFILE RECSIZE IS 256 
BYTES. 

CONTINUE OPERATION (Y OR N)? ¥ 

EOF FOUND IN FROMFILE AFTER RECORD 622 


623 RECORDS PROCESSED *** 0 ERRORS 


>EXIT 


> STORE 


: RESTORE 


:LISTF,2 


: SHOWOUT 


MPE COMMANDS AND INTRINSICS 
END OF SUBSYSTEM 


For additional information see the FCOPY Reference Manual (part 
number 0300-9006 4). 


You can use the :STORE command to store an environment file or component 
file on tape. 


:FILE TAPE;DEV=TAPE 
:STORE filename ;*TAPE 


You use the :RESTORE command to restore an environment file or component 
file from tape. 


:FILE TAPE;DEV=TAPE 
:RESTORE *TAPE; filename 


You can use the :LISTF,2 command to display a listing of all files within you 
group, account, or another group or account on the same computer system. 
You may use the :LISTF command without the ,2 paramter, however, the 
main emphasis here is to display the different file code and types for the 
various components available to an environment file. 


:LISTF @.CHARSETS.SYS,2 
will list all files in the CHARSETS group of the SYS account. 


You can use the : SHOWOUT command to report the status of output device files. 
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MPE Intrinsics 


FCHECK 


FFILEINFO 


FOPEN 


Jan 84 
A-4 


The FCHECK intrinsic returns error codes indicating errors encountered in 
processing the environment file, such as environment file open, close, or read 
errors, and uncompiled environment file error. 


You can use FFILEINFO to obtain the environment file name. 


You can use FOPEN to specify the Laser Printer as the output device, and to 
specify the environment file name. 





When you purchase the IFS Graphics software (HP 
36583), you can create new figure files through 
usage of the Figure Maker program, and update 
older graphics files using the Figure Update 
program. These two programs may be used as 
follows: 


The Figure Maker Utility 


Figure Maker is an HP3000 Graphics Utility 
which allows you to create your own figures in a 
figure file independent of any other graphics 
subsystem. Figure Maker is provided with the HP 
graphics software. 


Figures created with Figure Maker are treated in 
the same way as figures created using HPDraw and 
can be used with any of the following: 


~  IJFS/3000 graphics intrinsics 

- LPS Interpreter graphics commands 
-  HPDraw 

-  TDP/3000 


Figure Maker gives you a workspace 100 units 
square for the creation of your figures. You can 
move anywhere on this grid, draw lines as 
coordinates, and include text of various sizes as 
part of the figure. You determine the actual size 
of the figure when you use it in an application. 


100.0 


10.5,9.85 


0.0 





Figure B-1. Figure Maker Workspace 
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USING FIGURE FILES 
Converting Other Graphics 
Figures with Figure Maker 


If you have figures created from an editor file or drawing program other than HPDraw, you can use Figure 
Maker to convert the file to a figure file. For example, a file of line segment endpoints can be converted into 
a figure in a figure file which can then be used on the HP laser printer or other graphics output devices. 
Since most other drawing applications generate a different type of output than Figure Maker expects as input, 
a short intermediate program is necessary to format the vectors properly for input into the Figure Maker. 


Running Figure Maker 
Users of Figure Maker require DS (Extra Data Segments) Capability. If you have any questions about your 
user capabilities, check with your System Manager. 
After you have successfully logged on and received the MPE colon (:) prompt, type: 
:RUN FIGMAKER. PUB.SYS 
and press RETURN. 
The @ sign which is then displayed is Figure Maker’s prompt. 
You can create a figure by supplying an ASCII file of Figure Maker commands, or you can enter these 
commands interactively. 
Interactive 
When you enter Figure Maker commands interactively, your figure is created as you enter each command. 


This means that you cannot go back and change a previously entered command. If you want to modify the 
resulting figure, you have to re-enter all commands required to create the figure. 
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USING FIGURE FILES 


An example of interactive use is given at the end of this appendix. 


ASCII File 


The name of the file you supply can be an EDIT/ 3000 text file that contains Figure Maker commands. In 
this case, you can modify the figure by changing the text file and recreating the figure from this new file. 


You can use Figure Maker to convert the output from your own graphics application to a format compatible 
with Hewlett-Packard graphics subsystems. This is done by converting your vector file into a figure in a 
figure file. Since different applications generate different types of output, a short intermediate program will 
be necessary in order to format the vectors properly for input to Figure Maker. 


Examples of using an EDIT/3000 file and an outline of a conversion program are given at the end of this 
appendix. _ 


Commands 


The commands explained below are given in the order in which they would typically be used in a Figure 
Maker session. 


OPEMNFILE filename 


Opens the figure file named in the filename parameter. If the file does not exist, it is created now. You must 
use this command to open a figure file before you can begin creating a figure. Only one figure file can be 
open at a time. The file name must conform to the MPE file naming conventions. 


The number of figures that can be stored in a figure file depends on the size of each figure. If the file you 
specify is full, you receive an error message and should give another figure file name. 


A figure file is always created with a fixed amount of disc space. For the most effective use of space, it is 
best to put several figures in one figure file. 


BEGINFIG figurename 


Begins a new figure in the figure file specified with the OPENFILE command. The figure name parameter 
can be up to 16 characters long, must begin with a letter and can contain only letters, numbers and 
underscores (__). 
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MOVE x,y 


Moves to the specified coordinate point in the workspace. X and y are both real numbers and must have a 
positive value. The origin of the workspace is the lower left corner where x and y both have a value of 0. 
The value specified in the x parameter moves to the right; the y parameter moves up. The minimum value 
for x and y is 0.0; the maximum is 100.0. The MOVE command simply moves to the specified point; it does 
not draw a line as it moves. . 


DRAW xy 
Draws a straight line from the current position to the point specified. Like MOVE, x and y are real numbers 


and have a positive value. They should be specified relative to the origin of 0,0 and not relative to the 
current position. The minimum value for x and y is 0.0; the maximum is 100. 0. 


FONT number 

Allows you to select different fonts for text. The font number is an integer between 1 and 4 and corresponds 
to the following: Font 1 - Modern Light, Font 2 - Modern Medium, Font 3 - Modern Bold, and Font 4- 
Classic. The default is Font 1 - Modern Light. 

SIZE height 

A real number that defines the height of the text you want to draw. Height is specified in number of units. 
A height of 100.0 would fill the entire workspace. The height of the text remains in effect until a different 
height is specified in another SIZE command. Text height is measured from the top of uppercase to the 
bottom of the character descender, and includes some padding. The default text size is 2. 92 units. 

At the time of designing the figure, measurable size is not determined. You specify the actual size of the 
figure when it is used in a specific application. When creating the figure with Figure Maker, size is merely a 
proportional representation of 100 x 100 units. 


TEXT length “string” 


Draws the specified text at the current position. The length parameter gives the length of the text string in 
number of characters and must be an integer greater than or equal to 0. 


The string is the text you want to draw, and must be enclosed within quotes. 
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TEXTDIR text direction 

Positions the text at different angles by selecting the degrees at which you want the text positioned. If you 
select 45 for your angle, the text is positioned counter-clockwise at 45 degrees relative to the text position 
you chose. The angle is an integer between 0 and 359 inclusive. The default is 0. 


PEN pen number 


Selects the pen number you wish to use. Pen number applies to any multiple color device. The pen number 
parameter is an integer between 1 and 64 inclusive. The default pen number is 1. 


ARC xcenter, ycenter, degree length 


Draws an arc beginning at the current position. The center of the arc is specified by xcenter, ycenter. The 
length of the arc is specified by degree length. A positive degree length indicates a counterclockwise arc. 


COMMENT 


Allows you to include a comment line. You can have multiple line comments, but each line must be preceded 
by the COMMENT command. 


INCLUDE filename 


Executes the Figure Maker commands in the ASCII file named in the file name parameter. Included files can 
be nested up to ten levels. 


An example of including an ASCII file is given at the end of this section. 
ENDFIG 


Ends the current figure. If you are creating more than one figure in a session, the ENDFIG command must 
be used before using BEGINFIG to start a new figure. 


CLOSEFILE filename 


Closes the figure file named in the file name parameter. The file name must conform to the MPE file 
naming conventions and is the name of the figure file that is currently open. 
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USING FIGURE FILES 
EXIT 


Ends the Figure Maker session and returns you to the MPE Operating System as indicated by the colon 
prompt. 


END OF PROGRAM 


Updating Figure Files 


Files created using DSG/3000 version A.01.00, HPEasyChart version A.00.00, or HPDraw versions A. 00. 00 
and A.00.01 will need to be converted for use with the present version of IFS. Files need to be converted 
only once. To use the figure update program: 


1. Log into account as original creator. 


2. When the colon prompt appears, type: 

>RUN FUPDATE.PUB.SYS 
3. A banner will appear on the screen, followed by: 

Enter name of figure file to be converted (RETURN to exit): 
4. Enter the old file name after the colon. The following instruction appears: 


Enter a unique name for the old figure file: 
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5. When you enter the new file name, the screen displays: 
Figure file successfully converted. 


The updated figure file now exists under the original file name. This is so that any references to the original 
file name (in HPDraw) do not have to be changed. 


You can continue to enter names of figure files to be updated if you wish. The first instruction will be 
repeated. Press to exit. ; 


Note that the two file names cannot be the same. The old file is renamed (to the name specified in step 4). 
This enables you to archive the old file if you wish. Once you have successfully printed your updated figure . 
file, you may want to purge the old files from the system. 


For figure files created using a character set other than USASCII, run FUPDATE as follows: 
-RUN FUPDATE.PUB.SYS[;parm=lang] 


Where lang is as follows: 
2 - Swedish/Finnish 
3 - Norwegian/Danish 
4 - French 
5 - German 
6 - United Kingdom 
7 - Spanish 
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FIGMAKER EXAMPLES 
1. Interactive Commands 


@OPENFILE FIGURES 
@BEGINFIG FIG1 
@MOVE 20,20 
@DRAW 20,40 

@DRAW 40,40 

@DRAW 40,20 

@DRAW 20,20 

@MOVE 25.2,35 
@FONT 1 

@SIZE 5 

@TEXTDIR 0 

@TEXT 6 "Figure" 
@MOVE 25.2,30.3 
@TEXT 5 “Maker” 
@ENDFIG 
@CLOSEFILE FIGURES 
@EXIT 





Figure 
Viaker 


2. ASCII FILE - this produces the same figure as that created in example 1. 


Figure Maker Session: 


@OPENFILE FIGURES 
@BEGINFIG FIG1 
@USE MAKEFIG 
@ENDFIG 

@CLOSEFILE FIGURES 
@EXIT 
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USING FIGURE FILES 
EDIT/3000 Listing of MAKEFIG: 


COMMENT Draw a Box 
MOVE 20,20 

DRAW 20,40 

DRAW 40,40 

DRAW 40,20 

DRAW 20,20 

COMMENT Draw the Text 
MOVE 25.2,35 

SIZE 5 

10 TEXT 6 "Figure" 

11 MOVE 25.2,30.3 

12 TEXT 5 “Maker” 


OaONnN Ono hW ND 


3. PROGRAM OUTLINE FOR VECTOR CONVERSION 


In the following example, it is assumed that each vector is stored as a record consisting of four real 
numbers which determine its endpoints; that is (X1,Y1) (X2,Y2). Scaling of vector endpoints is necessary 
to conform to Figure Maker’s 100 x 100 unit workspace. 


OPEN Vector-List-File 
OPEN Figure-Maker-File 


WRITE (OPENFILE DIAGRAMS) to Figure-Maker-File 
WRITE (BEGINFIG SAMPLE_DIAGRAM) to Figure-Maker-File 


Determine scaling factors so endpoints lie in a 100x100 workspace. 


WHILE not End-of-File on Vector-List-File 
BEGIN 
READ (X1,Y1,X2,Y2) from Vector-List-File 
SCALE X’s and Y’s 
WRITE (MOVE X1 Yl) to Figure-Maker-File in ASCII 
WRITE (DRAW X2 Y2) to Figure-Maker-File in ASCII 
END 
WRITE (ENDFIG) to Figure-Maker-File 
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USING FIGURE FILES 


WRITE (CLOSEFILE DIAGRAMS) to Figure-Maker-File 
CLOSE Vector-List-File CLOSE Figure-Maker-File 
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USING FIGURE FILES 


ERROR MESSAGES 


Error 

Number Meaning 

401 Height specified is invalid. Must be a real number greater than O. 

0707 A figure file has already been opened. 

0708 The specified figure file has not been opened. 

1004 Text length is less than O. 

1501 A figure by that name already exists in the figure file. 

1508 A figure is currently being created. You must end the curr 
figure before doing a BEGINFIG. 

1509 File open intrinsic failed. 

1510 File close intrinsic failed. 

1517 A BEGINFIG command must be done before an ENDFIG command 

1518 Not a legal! figure name. 

1519 Figure file is full. The current figure cannot be put in the file. 
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THIS PAGE SHOULD BE BLANK 
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The environments supplied with IFS/3000 
simulate common printing devices such as line 
printers and typewriters. This appendix includes 
the specifications for these environments and gives 
possible logical page iocations. 


These environments are installed in the HPENV 
group in the SYS account. 


Environment files with more than one logical page 
use the same font for VFC, actual spacing and 
forms unless a 2:1 or 4:1 reduction is specified in 
which case a form is defined on each logical page. 


Figure C-1 illustrates the format of the HP 2680A 
environments listed in Table C-1 and Figure C-2 
illustrates the format of the HP 2688A 
environments listed in Table C-2. 


One major difference in these environments is the 
orientation of the logical pages. 


In all environments, the character fonts used are 
rotated to the same orientation as the logical page 
so that printing begins in the upper left corner of 
the logical page, as viewed in the direction of its 
orientation. 
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ENVIRONMENTS SUPPLIED WITH IFS/3000 





LP LP2 LP4 
Paper Motion LP60 | LP602 LP604 

LAND LAND2 LAND4 
Oo S ©) oO oO 
O eae O a 2 O Start of Start of Oo 
O inting O Ey 5 ©] | Printing Printing 0 
° ° 3 5 O ° 
Oo O co © O O 
° © © LP #0 LP #2 © 
oO Oo QO oO 
Oo Oo ‘e) O 
O O © Start of Start of oO 
Oo O © Printing Printing © 
oO O oO oO 
ro) @) Oo LP #1 LP #3 1?) 
Oo © O O 

1:1 : : 
PICA PICA2 PICA4 ( 
ELITE ELITE2 ELITE4 
Paper Motion DOC DOC2 DOC4 
PORT PORT 2 PORT4 


Start of Start of 
Printing Printing 


Bullulid 
Bullulig 
Bullulig 


COOO0000 


6) 2» a 
Oo 3 3 
O 3 s 
O © ‘© 
O 


OO00000 COC O00 0 
COO900O0O0O0O0 0000 0 
OFOOOCOOOC CO O0 00 
OOO9O0O0C0O0O 0000 0 
OO9OCCOO0OO0CO0O0O 00 


) 





2:1 


Figure C-i. HP 2680 Environment Formats 
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Paper Motion 


Printing 


1:1 


COURBA 
COURIA 
COURRA 
GOTHBA 
GOTHIA 
GOTHRA 


Start of 
Printing 


1:1 


LP88 





PICABA 
PICAIA 
PICARA 
PRESBA 
PRESIA 


PRESRA — 


ROMPBA 
ROMPIA 
ROMPRA 
SCRPRA 





Figure C-2 


Start of 
Printing 


Start of 
Printing 


Printing 


mn 
& 

~~ 

Cc 
‘<c 
a. 


LP882L 





LP882P 





ENVIRONMENTS SUPPLIED WITH IFS/ 3000 


io?) 

Cc 
pa) 

Cc 
oc 
a. 


Printing 


Start of 
Printing 


Start of 
Printing 


4:1 


. HP 2688 Environment Formats 


LP #0 


LP884L 


Printing 


Printing 





LP884P 


Start of 
Printing 


‘ 


LP #1 


Start of 
Printing 


LP #3 
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Table C-1. HP 2680A Environments Supplied with IFS/3000 























Logical | Orientation 



















Pages Per of Lines Per 
ENVIRONMENT Physical Logical Characters Logical 
FILE NAME! Description Reduction Page Pages Per Line Page 






















































LP Line Printer Landscape 132 66 
LP2 Line Printer Portrait 132 66 
LP4 Line Printer Landscape 132 66 
Line Printer Landscape 132 61 
Line Printer Portrait 132 61 
Line Printer Landscape 132 61 
Pica Typewriter Portrait 75 66 
Pica Typewriter Landscape 75 66 
Pica Typewriter Portrait 75 66 
ELITE Elite Typewriter Portrait 90 66 
ELITE2 Elite Typewriter Landscape 90 66 
ELITE4 Elite Typewriter Portrait 90 66 
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Lines stion{™) 
te 


Before/Af 
Print2 


3/3 
3/3 


3/3 


0/1 
0/1 


0/1 


3/3 
3/3 


3/3 


3/3 
3/3 


3/3 





Number 


#0 
#0 


#0 


on 


#0 


Pica 
Pica 


Pica 


Elite 


Elite 


Cis 








Character 
wxh Width? Height 
(Dots) (Dots) 


14 


Actual Spacing 
Line 





Files® 
P=Primary 
$=Secondary 
(P) LINEPR66 
(P) LINEPR66 


(P) LINEPR66 


(P) LINEPR60 
(P) LINEPR6O 


(P) LINEPR6O 


(P) PICA 
(P) PICA 


(P} PICA 


(P) ELITE 
(S) LT ITAL 
(P) ELITE 
(S) LT ITAL 
(P) ELITE 
(S) LT ITAL 


Character Font 










































Sample Applications 





This environment simulates a line printer including 
Auto-Page Eject off and skip to channel 11. With 
Auto-Page Eject off, 66 lines per page are printed, 
but printing does not extend to the edge of the 
paper because of the 1/2 inch margin required at 
the top and bottom of each physical page. For 
more information on Auto-Page Eject, refer to 
FCONTROL in the MPE Intrinsics Reference 
Manual (30000-90010). 









BORDERHPLP2 









BORDERHPLP4 







This environment simulates a line printer with 
Auto-Page Eject enabled except that a skip to 
channel 11 advances to top of form instead of one 
line above top of form. Use this environment for 
listings requiring only 60 lines, such as compiler 
listings. 





BORDERLP602 









BORDERLP604 












This environment simulates a typewriter with 
Pica type (10 characters per inch). You can pro- 
duce the effect of varying typing elements by 
adding character fonts to this environment. 





BORDERHPPICA2 










BORDERHPPICA4 


















BORDERHPELITE2 | This is the same as the Pica environment except 


that Elite prints 12 characters per inch. 









BORDERHPELITE4 
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ENVIRONMENT 
FILE NAME! 


DOC 


DOC2 


DOC4 


A A re RAI TNE Oe 


LAND 


LAND2 


LAND4 


ap 2A SA ERR A 


: PORT 
PORT 2 


| PORT4 
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Table C-1. HP 2680A Environments Supplied with IFS/3000 (continued) 


Description 


Document 


Document 


Document 


Landscape 
Landscape 


Landscape 


Portrait 
Portrait 


Portrait 


Reduction 


2:4 


4:1 


2:1 


4:1 


2:1 


4:1 








Logical 
Pages Per 
Physical 
Page 


Orientation 
of 
Logical 

Pages 


Portrait 


Landscape 


Portrait 


Landscape 
Portrait 


Landscape 


Portrait 
Landscape 


Portrait 
































Lines Per Lines Skippe 
Characters Logical Before/Afte 
Per Line Page Print2 
; Proportionally 
Spaced 66 3/3 
| Proportionally 
Spaced 66 3/3 
| Proportionally 
Spaced 66 3/3 





























5 Base Actual Spacing Character Font 
Character Font? Character Line Files 
\ Name/ wxh Width? Height P=Primary 





Number (Dots) (Dots) S=Secondary Sample Applications 











(P) ROM 































Roman 24x 25 24 30 (S) ROMBOLD The DOC (document) environment prints 60 lines 
ROMITAL of proportionally spaced characters (Auto - Page 
Eject off gives 66 lines). The horizonta! spacing 
(P) ROM is equivalent to 10-point characters and the verti- 
Roman 18x 19 18 20 (S) ROMBOLD cal spacing is equivalent to 12-point characters. 
ROMITAL Use this environment to produce high - quality 
printed material. 
(P) ROM 
Roman 7x 11 7 13 (S) ROMBOLD 
ROMITAL 








BORDERHPLP2 





The Landscape environment has logical pages 
similar to the line printer environment except that 
there are no character fonts. You normally use 
Landscape as the basis for creating new 
environments. 













BORDERHPLP4 







BORDERHPDOC2 





Portrait is used in the same way as Landscape. 
The difference between Landscape and Portrait 
is that with Landscape the logical page width 
exceeds the height, while with Portrait, the 
height exceeds the width. Portrait has logical 
pages similar to the DOC environment. 









BORDERHPDOC4 
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ENVIRONMENT 
FILE NAME1 


PICA1F 


PICA2F 





ELITE1F 





ELITE2F 


PICA1G 


PICA2G 


ELITE1G 








ELITE2G 
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Table C-1. 


Description 


Pica Typewriter 
(French) 

Pica Typewriter 
(French) 





Elite Typewriter 
(French) 

Elite Typewriter 
(French) 


Pica Typewriter 
(German) 

Pica Typewriter 
(German) 





Elite Typewriter 
(German) 

Elite Typewriter 
(German) 





HP 2680A Environments Supplied with IFS/3000 (continued) 








Logical 
Pages Per 
Physical 





























Orientation 
of 
Logical 

Pages 


Portrait 


Landscape 


Portrait 


Landscape 


Portrait 


Landscape 


Portrait 


Landscape 






Characters 
Per Line 
















90 


90 


75 


75 


90 


90 












Lines Per 
Logical 
Page 


66 


66 


66 


66 


66 


66 


66 


66 


Lines Skipped 
Before/After 
Print2 


3/3 


3/3 


3/3 


3/3 





3/3 


3/3 


3/3 


3/3 












Base 


Character Font? 
Name/ wxh 
Number (Dots) 







Character Font 
Files® 
P=Primary 
S=Secondary 


Actual Spacing 
Character Line 
Width4 Height 
(Dots) 












Sample Applications 


Pica 18 30 (P) PICAF This is the same as the Pica environment except 
that it contains ISO substitution characters for 
the French language. 

















Pica 12 20 (P) PICAF BORDERHPPICA2 





Elite 15 30 





(P) ELITEF This is the same as the Elite environment except 
that it contains ISO substitution characters for 


the French language. 









—. Elite 10 20 


(P) ELITEF BORDERHPELITE2 


























Pica 18 30 (P) PICAG This is the same as the Pica environment except 
that it contains ISO substitution characters for 

Pica 12 20 (P) PICAG BORDERHPPICA2 the German language. 

Elite 15 30 (P) ELITEG This is the same as the Elite environment except 
that it contains ISO substitution characters for 

Elite 10 20 (P}) ELITEG BORDERHPELITE2 the German language. 
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Table C-1. HP 2680A Environments Supplied with IFS/3000 (continued) 










ENVIRONMENT 
FILE NAME1 


PICAIN Pica Typewriter 
(Norwegian/Danish) 
PICA2N Pica Typewriter 


(Norwegian/Danish) 





ELITE1N Elite Typewriter 
(Norwegian/Danish) 
Elite Typewriter 


(Norwegian/Danish) 






ELITE2N 















PICA1S Pica Typewriter 
(Spanish) 

PICA2S Pica Typewriter 
(Spanish) 











ELITE1S Elite Typewriter 
(Spanish) 
Elite Typewriter 


(Spanish) 









ELITE2S 
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Logical 
Pages Per 


Physical 
Page 


1 


1 
2 
1 
2 
1 
2 


Orientation 


of 
Logical 
Pages 


Portrait 


Landscape 


Portrait 


Landscape 


Portrait 


Landscape 


Portrait 


Landscape 





Characters 
Per Line 


75 


75 


90 


90 


75 


75 


90 


90 


Lines Per 
Logical 
Page 





66 


66 


© 


Lines Skipped 
Before/After 
Print2 


3/3 


3/3 


3/3 


3/3 


3/3 


3/3 


3/3 


3/3 














Base 


Character Font? 
Name/ wxh 
Number (Dots) 







Character Font 
Files 
P=Primary 
S=Secondary 


Actual Spacing 
Character Line 
Width4 Height 
(Dots) > 















Sample Applications 








































Pica 18 30 (P) PICAN This is the same as the Pica environment except 
that it contains ISO substitution characters for 

Pica 12 20 (P) PICAN BORDERHPPICA2 the Norwegian and Danish languages. 

Elite 15 30 (P) =LITEN This is the same as the Elite environment except 
that it contains ISO substitution characters for 

‘on 10 20 (P) ELITEN BORDERHPELITE2 the Norwegian and Danish languages. 

Pica 18 30 (P) PICAS This is the same as the Pica environment except 
that it contains ISO substitution characters for 

Pica 12 20 (P) PICAS BORDERHPPICA2 the Spanish language. 

Elite 15 30 (P) ELITES This is the same as the Elite environment except 
that it contains ISO substitution characters for 

Elite 10 20 (P) ELITES BORDERHPELITE2 | the Spanish language. 
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Table C-1. HP 2680A Environments Supplied with IFS/3000 (continued) 


































































































Logical Orientation 
Pages Per of Lines Per Lines Skipped 
ENVIRONMENT Physical Logical Characters Logical Before/After 
FILE NAME1 Description Reduction Pages Per Line Print2 
PICA1W Pica Typewriter 1 Portrait 75 66 3/3 
(Swedish/Finnish) 
PICA2W Pica Typewriter 2:1 2 Landscape 75 66 3/3 
(Swedish/Finnish) 
ELITE1W Elite Typewriter 1 Portrait 90 66 3/3 
(Swedish/Finnish) 
ELITE2W Elite Typewriter 2:1 2 Landscape 90 66 3/3 
(Swedish/Finnish) © 
PICA1U Pica Typewriter 1 Portrait 75 66 3/3 
(U.K. English) 
PICA2U Pica Typewriter 2:1 2 Landscape 75 66 3/3 
(U.K. English) 
ELITE1U Elite Typewriter 1 Portrait 90 66 3/3 
(U.K. English) 
ELITE2U Elite Typewriter 2:1 2 Landscape 90 66 3/3 
(U.K. English) 
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Base Actual Spacing Character Font 
Character Font3 Character Line Files® 
Name/ wxh Width4 Height P=Primary 






Number (Dots) (Dots) S=Secondary Sample Applications 































Pica 18 30 (P) PICAW This is the same as the Pica environment except 
that it contains ISO substitution characters for 

Pica 12 20 (P) PICAW BORDERHPPICA2 the Swedish and Finnish languages. 

Elite 15 30 (P) ELITEW This is the same as the Elite environment except 
that it contains ISO substitution characters for 

Elite 10 20 (P) ELITEW BORDERHPELITE2 the Swedish and Finnish languages. 




























Pica 18 30 (P) PICAU This is the same as the Pica environment except 
that it contains ISO substitution characters for 

Pica 12 20 (P) PICAU BORDERHPPICA2 the United Kingdom language. 

Elite 15 30 (P) ELITEU This is the same as the Elite environment except 
that it contains ISO substitution characters for 

Elite 10 20 (P) ELITEU BORDERHPELITE2 the United Kingdom language. 





Table C-1. HP 2680A Environments Supplied with IFS/3000 (continued) 


















Logical Orientation 
Pages Per of Lines Per 
Physical Logical Characters Logical 
Page Pages Per Line 










Lines Skipped 
Before/After 
Print2 












ENVIRONMENT 
FILE NAME1 







Description Reduction 



















ELITE1X Elite Typewriter Portrait 3/3 
with Roman 
Extension 

ELITE2X Elite Typewriter Landscape 3/3 
with Roman 






Extension 


Elite Typewriter Portrait 3/3 y 
Italics with 


Roman Extension 
Elite Typewriter : Landscape 3/3 
Italics with 

Roman Extension 





LTITAL1X 











LTITAL2X 
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Base Actual Spacing Character Font 
Character Font3 Character Line Files 
Name/ wxh Width4 Height P=Primary 







Number (Dots) (Dots) S=Secondary Sample Applications 










This has the same format as the Elite environment. 
The primary font is Elite, the secondary font is 
the Roman Extension to Elite. 


(P) ELITE 
(S) ELITEX 












Elite (P) ELITE 


(S) ELITEX 





BORDERHPELITE2 






(P) LTITAL This has the same format as the Elite environment. 
(S) LTITALX The primary font is Elite Italics; the secondary 
font is the Roman Extension to Elite Italics. 







Ltital (P)LTITAL 
(S) LTITALX | BORDERHPELITE2 
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Table C-1. HP 2680A Environments Supplied with IFS/3000 (continued) 






































Logical Orientation 
Pages Per of Lines Per Lines Skipped 
ENVIRONMENT Physical Logical Characters Logical Before/After 
FILE NAME1 Description Reduction Pages Per Line Page Print2 





PICA1X Pica Typewriter Portrait 
with Roman 
Extension 

Pica Typewriter 
with Roman 


Extension 
























PICA2X Landscape 3/3 





















Document Portrait Proportionally 





3/3 im, 

















with Roman Spaced 

Extension 

Document Landscape Proportionally 3/3 
with Roman Spaced 


Extension 







Portrait 3/3 





SCRIPT1X Script Typewriter 
with Roman 


Extension 







Jan 8&4 
C-16 




















Base Actual Spacing Character Font 
Character Font? Character Line Files® 
Name/ wxh Width4 Height P=Primary 








Number (Dots) (Dots) S=Secondary Sample Applications 













This has the same format as the Pica environment. 
The primary font is Pica; the secondary font is 
the Roman Extension to Pica. 


(P) PICA 
(S) PICAX 








(P) PICA 
(S) PICAX 






Pica 






BORDERHPPICA2 










This has the same format as the DOC environment. 
The primary font is Roman; the secondary font is 
the Roman Extension to Roman. 


(P) ROM 
(S) ROMX 





Coe" 


Roman 











(P) ROM 
(S) ROMX 






BORDERHPDOC2 






This has the same format as the Elite environment. 
The primary font is Script; the secondary font is 
the Roman Extension to Script. 


(P) SCRIPT 
(S) SCRIPTX 
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Table C-1. HP 2680A Environments Supplied with IFS/3000 (continued) 





















Logical Orientation 




























Pages Per of Lines Per 
ENVIRONMENT Physical Logical Characters Logical 
FILE NAME' Description Reduction Page Pages Per Line Page 

























LPK Katakana 1 L 132 66 
Charsets 

LPK2 Katakana 2 P 132 66 
Charsets 

LPK4 Katakana 4 L 132 66 
Charsets 

PICAK Katakana 1 P 75 66 
Charsets 

PICA2K Katakana 2 L 75 66 
Charsets 

PICA4K Katakana 4 P 132 66 


Charsets 
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Lines skippe(_) 
Before/After 
Print? 
3/3 


3/3 


3/3 


3/3 
3/3 


3/3 

















Actual Spacing 
Character Line 
Width‘ Height 
(Dots) 


Character Font 
| Files® 

P=Primary 
S=Secondary 












(Es Base 
‘. Character Font® 


Name/ wxh 
Number (Dots) 











Sample Applications 




























#0 14 20 (P) LNPR66K 
(S) LNPR66KX 
#0 10 15 (P) LNPR66K BORDERHPLP2 
(S) LNPR66KX 
#0 7 10 (P) LNPR66K BORDERHPLP4 
(S) LNPR66KX 
PICA 18 30 (P) PICAK 
(S) PICAKX 
PICA 12 20 (P) PICAK BORDERHPPICA2 
( 


S) PICAKX 
(P) PICAK 
(S) PICAKX 


BORDERHPPICA4 





PICA 9 15 
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ENVIRONMENT 
FILE NAME’ 





Description 









Courier 

Typewriter Bold 
Courier Italics 
Typewriter Italics 
Courier 

Typewriter Regular 


COURBA 








COURIA 














COURRA 







Gothic 

Typewriter Bold 
Gothic 

Typewriter Italics 
Gothic 

Typewriter Regular 








GOTHBA 









GOTHIA 





GOTHRA 













LP88& Line Printer 







LP882L Line Printer 







LP882P Line Printer 





LP884L Line Printer 





LP884P 





Line Printer 






PICABA Pica 
Typewriter Bold 
Pica 

Typewriter Italics 
Pica 

Typewriter Regular 










PICAIA 












PICARA 
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Logical 
Pages Per 
Physical 
Reduction 


Table C-2. HP 2688A Environments Supplied with IFS/3000 


Orientation 
of 
Logical 
Pages 


Characters 
Per Line 





15 


15 


75 


Lines Per 
Logical 





66 


66 


66 


Lines skippe(_) 
Before/After 
Print? 
3/3 


3/3 


3/3 


3/3 
3/3 


3/3 





3/3 


3/3 


3/3 


3/3 


3/3 


3/3 


3/3 





3/3 





Base 
Character Font? 


Name/ 
Number 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


#0 


wxh 
(Dots) 


25 50 
25 50 


25 50 











Character Font 
Files® 
P=Primary 
S=Secondary 







Actual Spacing 
Character Line 
Width‘ Height 
(Dots) 











Sample Applications 
















(P) COURB88S 
(S) COURB88X 
(P) COURI88S 
(S) COURI88X 
(P) COURR88S 
(S) COURR88X 


30 50 





| (P) GOTHB88S 
(S) GOTHB88X 
(P) GOTHI88S 
(S) GOTHI88X 
(P) GOTHR88S 
(S) GOTHR88X 










(P) LINEP88s 
(S) LINEP88X 






BORDERHPLP882L 


BORDERHPLP882P 


BORDERHPLP884L 


BORDERHPLP884L 








(P) PICAB88S 
(S) PICAB88X 
(P) PICAI88S 
(S) PICAI88X 
(P) PICAR88S 
(S) PICAR88X 
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Table C-2. HP 2688A Environments Supplied with IFS/3000 (continued) 


Logical . Orientation 
Pages Per of Lines Per Lines skipp{_) 


Physical Logical Characters Logical Before/After 
Description Reduction Page Pages Per Line Page Print? 








ENVIRONMENT 
FILE NAME’ 
























PRESBA Prestige Elite 1 90 66 3/3 
Typewriter Bold 

PRESIA Prestige Elite 1 90 66 3/3 
Typewriter Italics 

PRESRA Prestige Elite 1 90 66 3/3 






Typewriter Regular 






































ROMPRA Times Roman 66 3/3 
Prop. (Doc) Bold 

ROMPIA Times Roman 66 3/3 
Prop. (Doc) Italics 

ROMPRA | Times Roman 66 3/3 
Prop. (Doc) Regular 

SCRPRA Typewriter 1 3/3 
Script 
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Base 


Character Font 
Name/ wxh 
Number (Dots) 

#0 25 50 
#0 25 50 
#0 25 50 
#0 40 50 
#0 40 50 
#0 40 50 

#0 25 50 


Actual Spacing 
Character Line 














Character Font 
Files® 
P=Primary 
S=Secondary 














Sample Applications 


(P) PRESB88S 
(S) PRESB88X 
(P) PRESI88S 
(S) PRESI88X 
(P) PRESR88S 
(S) PRESR88X 























(P) ROMPB88S 
(S) ROMPB88X 
(P) ROMPI88S 
(S) ROMPI88X 
(P) ROMPR88S 
(S) ROMPR88X 






(P) SCRPT88S 
(S) SCRPT88X 
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Table C-2. HP 2688A Environments Supplied with IFS/3000 (continued) 





Logical Orientation 

Pages Per of Lines Per Lines skippe() 
Physical Logical Characters Logical Before/After wm 

Description Reduction Per Line Page Print? 





ENVIRONMENT 
FILE NAME’ 













COUR88A HPWORD 3/3 
Charsets 
COUR88E HPWORD 3/3 









Charsets 

















HPWORD 
Charsets 


GOTH88A 











HPWORD 
Charsets 


GOTH88E 






3 99 66 3/3 
3 96 70 3/3. 
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C 


Base 
Character 
Name/ 
Number 


Font? 
wxh 
(Dots) 


Width‘ 


Actual Spacing 
Character Line 





Height 


(Dots) 


25 













































Character Font 
Files 
P=Primary 
S=Secondary 


COURR88S 
COURR88X 
COURB88S 
COURB88X 
COURI88S 
COURI88X 


COURR88S 
COURR88X 
COURB88S 
COURB88X 
COURI88S 
COURI88X 


GOTHR88S 
GOTHR88X 
GOTHB88S 
GOTHB88X 
GOTHI88S 

GOTHI88xX 


GOTHR88S 
GOTHR88X 
GOTHB88S 
GOTHB88X 
GOTHI88S 
GOTHI88X 


















Sample Applications 
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Table C-2. HP 2688A Environments Supplied with IFS/3000 (continued) 
























Orientation 
of 
Logical 


Logical 
Pages Per 
Physical 







Lines Per 
Logical 













Characters 
Per Line 


Lines stipp™) 
Before/Afte 


Print? 


ENVIRONMENT 
FILE NAME' 









Description Reduction 









PROP88A HPWORD 


Charsets 








HPWORD 
Charsets 


PROP88E 3/3 
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C-26 
















E> Base Actual Spacing Character Font 
Character Font® Character Line Files® 
\ Name/ wxh Width‘ Height P=Primary 









Number (Dots) (Dots) $=Secondary Sample Applications 
























ROMPR88S 
ROMPR88X 
ROMPB88S 
ROMPB88X 
ROMPI88S 
ROMPI88X 


ROMPR88S 
ROMPR88X 
ROMPB88S 
ROMPB88X 
ROMPI88S 
ROMPI88X 
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1. These are HP-defined environment files located in the HPENV group of the SYS account. 


2. If Auto-Page Eject is disabled, the lines skipped before/after print values are ignored resulting in 0 lines skipped before the first line of print and after the 
last one. 

3. Font for VFC width and height are listed only when different from the actual spacing. 

4. For proportionally spaced characters fonts, the maximum cell width is listed. 

5. The character font files are in the CHARSETS group of the SYS account. 

6. The forms are contained in the forms file named BORDERS in the HPENV group in the SYS account. 
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This appendix contains the file names and samples of all the character fonts supplied with the purchase of 
IFS/3000 for use on the HP 2680 and 2688 Laser Printers. The information is organized as follows: 


HP 2680 CHARACTER FONTS ..... 2... 2 2 D-2 
Proportionally Spaced Characters... 2... 2. D-2 
Fixed Space Characters .. 2... 1 2 ee ee D-6 
ISO Substitution Characters... .............0004 eee et ee et th ee we te D-14 
Roman Extension Characters... 2... 0 0 ee D-26 
Special Characters... 0... ke ke coe D-30 
Bar Codes .. 2... 2. ee D-35.1 
MORE ABOUT BAR CODES.............0.00. 000 eee D-36 
HP 2688 CHARACTER FONTS ...... 2... 2 2 2 D-40 
Fixed, Proportional, and Roman Extension Characters ............00 0000. ee eeeeuu D-40 
Special Characters... 0... ee D-52 
Bar Codes ........... a D-54 

Sept 84 


D-1 


D-1. HP 2680 Character Fonts Supplied With !FS/3000 


CHARACTER FONT 
FILE NAME 












Cell Size Baseline ADDITIONAL INFORMATION 
Point Width Height 
Size (in dots) (in dots) 





Proportionally Spaced Characters: 


The digits 0-9, the plus sign (+), minus sign (-) & dollar 
sign ($) have fixed spacing. 


HELV.CHARSETS.SYS 





The digits 0-9, the plus sign (+) , minus sign 
(-) & dollar sign ($) have fixed spacing. 


HELVITAL.CHARSETS.SYS 





Sept 84 
D-2 


CHARACTERS 






I" $%&'()* +,-./0123456789:<=>7@ 
ABCDEF GHIJKLMNOPQRSTUVWXYZ[\]*_* 
abcdefghijklmnopaqrstuvwxyz{|}~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 










"# $%&'()*+, -./0123456789:<=>?@ 
ABCDEF GHIJKLMNOPQRSTUVWXYZ[\] 
abcdefghijkimnoparstuvwxyz§[}~ 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 






a 







YP #$%&'O* +, -/0123456789:<=>9@ 
ABCDEF GHISKLMNOPQRSTUVWXYZ[\] 
abcde fghijkimnopqrstuvwxyz{}}~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 









a 










"# $%RIO*K+,-./01 234567 89:;<=>7@ 
ABCDEF GHIJKLMNOPQRSTUVWXYZ[\] 
abcdefghijkimnoparstuvwxyz{|}~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 





A 








"REZE’ ()* +,-./01234567 89: ;<=>2?@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_~ 
abcdefghijkimnopqrstuvwxyz{[3}~ 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font 












"#$%8 ()¥+,-./01234567 89::<=>79@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ{\]*_* 


abcdef ghi jkimnoparstuvwxy z{|}~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 






Sept 84 
D-3 


D-1. HP 2680 Character Fonts Supplied With IFS/38000 











CHARACTER FONT 
FILE NAME 


Cell Size Baseline ADDITIONAL INFORMATION 






Point Width Height 





Size (in dots) (in dots) 


For 8, 11.2, & 14 point, the digits 0-9, the 
plus sign (+), minus sign (-) & dollar sign 
($) have fixed spacing. For 24 point, all 
characters are proportionally spaced. 


HELVBOLD.CHARSETS.SYS 
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D-4 





CHARACTERS 


HS %&’()*+,-./01234 
ABCDEF GHIJKLMNOP 
abcdefghijkimnoparst 


1°# $%&'()* +,-./0123456789:;<=>? 
ABCDEFGHIJKLMNOPQRSTUVWXY 
abcdefghijkimnopaqrstuvwxyz{|}* 


1" # $%&'()* +,-./0123456789:;<=>7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_* 
abcdefghijkimnopaqrstuvwxyz{|}* 


"# $%&'()¥+,-./0123456789:;<=>7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_ 
abcdefghijkimnopaqrstuvwxyz{|}~ 


Here is some text 


Here is some text printed in 
the selected font. The line 
spacing is set by the font al 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


so. 
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D-5 


D-1. HP 2680 Character Fonts Supplied With IFS/3000 


CHARACTER FONT 







FILE NAME 


Size 


ROM.CHARSETS.SYS 11.2 


10 


ROMITAL.CHARSETS.SYS 11.2 


10 


Sept 84 
D-5.1 


Cell Size 


(in dots) 


27 


24 


12 


27 


24 


18 


Point Width Height 


28 


25 


12 


28 


25 


12 


Baseline 


(in dots) 





ADDITIONAL INFORMATION 





The digits 0-9, the plus sign (+), minus sign (-) & dollar 
sign ($) have fixed spacing. 


The digits 0-9, the plus sign (+), minus sign (-) & dollar 
sign ($) have fixed spacing. 








CHARACTERS 





"#$A&'()*+,-./012345678 9:<=>2@ Here is some text printed in 
ABCDEFGHIJKLMNO PQ RSTUVWXYZI|\]*__ the selected font. The line 
abcdef ghijklmnopqrstuvwxyz{|}~ Spacing is set by the font 
MA $SLZ&R'()*+,-./01234567 89:<=>2@ Here is some text printed in 
ABCDEFGHIJKLMNOPORSTUVWXYZI\I*__ ‘ the selected font. The line 
abcdef ghijkIlmnopaqrstuvwxyz{|}7 spacing is set by the font also. 
"4 $Z&’7O*+,-./0123 45678 9: <=>?@ Here is some text printed in 
ABCDEFGHIIKLMNOPQRSTUVWXYZIN\I*__* the selected font. The line 
abcdef ghijkimnopqrstuvwxyz{|}~ spacing is set by the font also. 
eere O*+,-./01234567893<2°@ Here is some text printed in 
‘ab DEFGHIJ LMNOPQRSTUV WXYZi\}"_ the selected font. The line 
abcdefghijkimnopqrstuywxyz{}}~ spacing is set by the font also. 
MH3SBE& ()* +,-./0123456789.;<=>2@ Here is some text printed in 
ABCDEFGHIJKLMN OPORS TUVWXYZ[\]*_' the selected font. The line 
abcdef ghijklmnopqrstuvwxyz{|}” spacing is set by the font 
MH SKE )* +,-./01234567 89:;<=>2@ Here is some text printed in 
ABC DEFGHIJKLMNOPQRSTUVWXYZI[\]*_< the selected font. The line 
abcdef ghijklmnopgrstuvwxyzi | }~ spacing is set by the font also. 
1" SNR’ ()* 4,-./0123456789.;<=>?@ Here is some text printed in 
eo’ ABCDEFGHIJKLMNOPORSTUVWXYZ[\]*_* the selected font. The line 
abcdefghijklmnopgrstuvwxyzf {}~ Spacing is set by the font also. 

ABCDELGHIIREMNOPORSTOVWATZINIW- the selected font. The tine” 

adcdef ghijkianoparstuvwxyz{| 3” spacing tg get by the font aigo. 


Sept 84 
D-5.2 


D-1. HP 2680 Character Fonts Supplied With IFS/3000 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 





Size (in dots) (in dots) 
ROMBOLD.CHARSETS.SYS 11.2 27 28 7 The digits 0-9, the plus sign (+) , minus sign 
(-) & dollar sign ($) have fixed spacing. 
10 25 25 7 
8 18 19 6 
¢ ; 3 
5 12 12 4 





Sept 84 
D-5.3 











CHARACTERS 


MA#S$LR()*+,-./0123456789;;<e>?@ 


ABCDEFGHIJKLMNOPQRSTUVWXYZI\]*_‘ 


abcdef ghijklmnopqrstuvwxyz{|}* 


UH S$AK&'()*+,-./0123456789:;<=>9@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZI\|*__* 
abcdefghijklmnopqrstuvwxyz{|}~ 


UB SKE?()*+,-./0123456789:;<=>7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZI\}*__~ 
abcdefghijkimnopqrstauvwxyz{}h~ 


UH BH BPO* +, =f8 12345678 95692 
ABCDEFGHISKLMNOPQRSTUVWXYZI\)__” 
abcdefghijkimnopaqrstuvwxyz{|}~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here ts some text printed in 
the selected font. The line 
spacing is set by the font also. 





Sept 84 
D-5.4 


CHARACTER FONT 
FILE NAME 


Fixed Space Characters: 


BIGONES.CHARSETS.SYS 


COUR.CHARSETS.SYS 


COUR12.CHARSETS.SYS 


Jan 84 
D-6 


D-1. 





HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size Baseline ADDITIONAL INFORMATION 


Point Width Height 
Size (in dots) (in dots) 


This character font file contains only the digits 0-9 & the 
section symbol §. This symbol is printed by typing a 
tilde(~). 


O 





CHARACTERS 





1"#S$%&'()*+,-./0123456789: ;<=>?@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_* 
abcdefghi jklmnopqrstuvwxyz{|}~ 


1"#$28? ()¥*+,-./0123456789: 3 <=> 
ABCDEFGHIJKLMNOPQRSTUVWKYZ[\]~ 
abcdefghijklmnoparstuvwxyz{ | }~ 


2@ 


1 "#$%&' () *+,~./0123456789: ; <=>?@ 
ABCDEF GHIJKLMNOPQRSTUVUXYZ[\}*_* 
abcdef ghijkimnoparstuvuxyz{ | }~ 


1"#S%&' ()*+,-./0123456789: ;<=>?@ 
ABCDEFGHIJKLMNOPQRSTUVWKYZ[\]*_~ 
abcdefghijkimnopgrstuvwxyz{ | }~ 


1" #$%8? ()¥+ ,-. /0123456789: ; <=>2@ 
ABCDEFGHI JKLMNOPQRSTUVUXYZ[\]*_~ 
abcdefghi jklmnoparstuvuxyz{ | }~ 


"HS$Z8? ()*4, -. /0123456789: 5 <=>7@ 
ABCDEF GHIJKLMNOPGRS TUVWXYZ [\ ]*_* 
abcdef ghi jklnnopgrstuvuxyz{ | }~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
spacing is set by the font also. 


Jan 84 
D-7 


D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT 


Cell Size Baseline 
FILE NAME 


ADDITIONAL INFORMATION 


Point Width Height 
Size (in dots) (in dots) 


Fixed Space Characters: (Continued) 


COURITAL.CHARSETS.SYS 


ELITE.CHARSETS.SYS 





LRGELITE.CHARSETS.SYS 
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CHARACTERS 


L"HS%LE! ()*4,-./0123456789: ;<=>?@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ [\]~_~ 
abcdefghijklmnopqrstuvwxyz{ | }~ 


LUHSZAR! C)** - . /0123456789: 5 <=>?@ 
ABCDEFGHT J KLMNOPQRSTUVWXYZI\ ]° 
abedefght jklmopgqrst uvuxye2{ | 3~ 


LHORR! ()*4,~. /0123 956789: 5 <=>2@ 
ABCDEF GHIJKLUNOPQRSTUVUXYZ{\ }*_~ 
abcde fghi gkimnopgrstuvwxyzt | }~ 


1" #$HE' ()*+,-. /0123456789: ;<=>70 
ABCDEF GHIJKLMNOPQRSTUVWKYZ[\]*_~ 
abcdefghijklmnopqrstuvwxyz {| }~ 


1" #$28? ()¥+,-. /0123456789: :<=>7@ 
ABCDEFGHI JKLMNOPQRSTUVUXYZ[\]*_* 
abcdefghijkimnopqrstuvuxyz{ | }~ 


HELE" ()*4, -. 0123456789: <=> 78 
ABCDEFGHIJK LANOPQRSTUVUXYZ{ \)*_* 
abcdefgha jk nnoparstuvuxyz{ | }” 


I"#$%&’ ()*+,-./0123456789: ; <=>2@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_* 
abedefghi jklmnopqrstuvwxyz{ | }~ 


1"#$28? ()*+ ,-. /0123456789: 5 <=>2@ 
ABCDEFGHI JKLMNOPQRSTUVUXYZ[\]*_~ 
abcdefghi jklmnoparstuvuxyz{ | }~ 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here ts some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The lina 
spacing is set by the font atso. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 
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D-9 


D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 

FILE NAME 

Point Width Height - 
Size (in dots) (in dots) [ 


Fixed Space Characters: (Continued) 


LRGELITE.CHARSETS.SYS 6 7 15 5 


LTITAL.CHARSETS.SYS 12 17 30 10 





8 11 20 7 
6 9 15 6 
PICA.CHARSETS.SYS 12 18 30 8 
8 12 20 5 
6 9 15 5 
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D-10 


C 


CHARACTERS 


'"WEZR? ()*+,-. 0123456789: 5 <=>78 
ABCDEF GHIJKLNNOPORSTUVUXY2(\]7_* 
abcdef ghia jk lnnopqrstuvuxyz{ | }~ 


INH#SEE' ()*4+,~-./0123456789: ;<=>7@ 
ABC DEFGHIJKLMNOPQRSTUVWXYZ[\]* ~ 
abedefghijklmopaqrstuvwayz { | }~ 


LUHSEB' C)*+ ,- ./0123 456789: 5 <=>2@ 
ABCDEFGHT JKLMNOPQRSTUVWXYZI\]* _~ 
abcdefghijklmmopqrstuvuxyz {| }~ 


BORE ()*4,-./0123$56789: 5+ 2+7@ 
ABCDEF GHITK LHNOPQRSTUVUXYZ{\ }* ~ 
abcdefght jklmnoparstuvwxyz {|} 


1"#$%&'()*+,-./0123456789:;<=>2@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]* 
abcdefghijklmnopqrstuvwxyz{|}~ 


x 


LV#E%&? ()¥+,-./0123456789: + <=> 
ABCDEFGHI JKLMNOPQRSTUVWXYZ[\]~ 
abcdefghijklmopgrstuvwxyz{ | }~ 


2@ 


1 *#$X8’ ()*+, -./0123456789: <=> 70 
ABCDEFGHIIKLMNOPORS TUVWXYZ [\}7_* 
abcdefghijklmnopars tuvwxyz{}}7 


Here is some text printed in 
the selected font. The line 
spacing 18 set by.the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here ts some text printed in 
the selected font. The line 
spacing ts set by the font also. 


Here ts some text printed in 
the selected font. The line 
spacing ts set by the font also. 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here 18 some text printed in 
the selected font. The line 
spacing 18 set by the font also. 
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D-11 


D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline 


ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) 





Fixed Space Characters: (Continued) 


LINEPR6O.CHARSETS.SYS 


LINEPR61.CHARSETS.SYS 


LINEPR66.CHARSETS.SYS 
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D-12 





CHARACTERS 


1"#$%8&' ()*+, -./0123456789: ;< 
ABCDEF GHI JKLMNOPQRS TUVWXYZ. \ 17_ 
abcdef ghijklmnoparstuvwxyz {| 


>? 
na “ 


'"8$X8' Cet, ~./0123456789: 5 <=>27@ 
ABCDEFGHI JKLMNOPQRSTUVUXYZ [\]*_ 
abcdefghijklmnopaqrstuvuxyz{ | }” 


i >()Be, -. /0123456789: 1 <=> 76 ¢ 
necoerok secaWoransruvuxr2l\} 
abcdefghijkimnoparstuvuxyz | 


P"#$Z%&' ()k+,-. /0123456789: -<=>7@ 


ABCDEFGHIJKLMNOPQRSTUWWXYZ[\ ]* . 
abcdefghijkImnopqrstuvwxyz{|}~_ 


P"e$x&’ ree ~./0123456789: 5 <= >2@ 
ABCDEFGH IKLMNOPQRSTUVWXYZ[\]*_* 
abcde fghijkimnoparstuvwxyz{ | }~_ 


SREB? ()E - /0123456789: 3 
ABCOEFGHIJKLMNOPORSTINLIX YZ 


<=>7@ 
\e 
apcdefghijkinnoparst Uvuayet | }-- 


i"#$Z%&' ()K+, -. /0123456789: ; <=> 
ABCDEFGHIJKLMNOPQRSTUVWXYZE\]*__ 
abcdefghijklmnopqrstuvwxyz{{}~ 


°@ 


1" #$x%8? ree ~ . 40123456789: ;<=>7@ 
ABCDEFGH JKLMNOPQRSTUVUXYZ[\ ] > . 
abcde fghijkimnopqrstuvwxyz{|}~ 


“BEAR 19123456789: 4 ¢= 
ABCOEFGH I IKiMKOSURS nee YZt\}- as 
abcdefgh ijk innopar stuvacyes | -~ 


Here is some text printed in 
the selected font. The line 


spacing is set by the font also. 


Here 1S some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here 18 some text printed in 
the selected font. The tin 
spacing 18 set by the font also. 


Here is some text printed in 
the selected font. The line 


spacing is set by the font also. 


Here 1s some text printed in 
the selected font. The line 
spacing 1s set by the font also. 


Here is sone text printed in 
the selected font. The fin 
spacing ts set by the font also. 


Here is some text printed in 
the selected font. The line 


spacing is set by the font also. 


Here 15 some text printed in 
the selected font. The line 
spacing 15 set by the font also. 


Here is sone text printed oy 
the setected font. The J1 
spacing 18 set by the font nalso. 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline | ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) @& 


Fixed Space Characters: (Continued) 


SCRIPT.CHARSETS.SYS 


ISO Substitution Characters: 


ELITEF.CHARSETS.SYS This is the same as the Elite character font except that it 
(FRENCH) contains ISO substitution characters for the French Language 


CO 


ELITEG.CHARSETS.SYS 


This is the same as the Elite character font except that it 
(GERMAN) 


contains ISO substitution characters for the German Language. 
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D-14 


CHARACTERS 


1"#$26"()*+,-./0123456789: ;<=>2@ 
ABCDEFGH TI JKLMNOPORST UVWXYZ[\]*_— 
abede fights klmnopqrstuvuxyz {| }~ 


L"#$%&' ()*+,-. /0123456789: 3<=>7a 
ABCDEF GHI JKLMNOPQRSTUVWXYZ° ¢§* > 
abcdefghijklmnopaqrstuvwxyzeue” 


1'#$%8? ()¥+,-. /0123456789: +<=>?a 
ABCDEFGHI JKLMNOPQRSTUVUKYZ°c$*_~ 
abcdefghi jklmnopqrstuvuxyzéue” 


"H$ZR? ()*+, ~. /0123456783: 5<=>7 
ABCDEF GHIJKLMNOPQRSTUVWKYZ°C§*_* 
abcdef ghi jklnnoparstuvuxyzeue” 


1" £$%&' ()¥+,-. /0123456789: 3 <=>7§ 


eeocee 


ee e 


abcdefghijkimnopaqrstuvwxyza6uB 


I"E$LR? ()¥+ ,-. /0123456789: + <=>2§ 


abcdefghi jklmnopars tuvuxyzaouB 


1M ESAB? ()¥+, -. £0123456789: 5 <=>7§ 
ABCDEFGHIJKLMNGPORSTUVWXYZA0U™ * 
abcdef ghi jk mnopqrstuvuxyzaauB 


Here 44 some text printed in 
the selected font. The Line 
spacing 44 set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
spacing is set by the font also. 
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D-1. 


CHARACTER FONT 
FILE NAME 


1SO Substitution Characters: 
(Continued) 


ELITEN.CHARSETS.SYS 
(NORWEGIAN/ 
DANISH) 


ELITES.CHARSETS.SYS 
(SPANISH) 
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HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size 
Point Width Height 
Size (in dots) 
12 15 30 
8 10 20 
6 7 18 
12 15 30 
8 10 20 
6 7 18 


Baseline 


(in dots) 


| This is the same as the Elite character font except that | 


ADDITIONAL INFORMATION 


This is the same as the Elite character font except that it 


contains ISO substitution characters for the Norwegian and 


Danish Languages. 





contains ISO substitution characters for the Spanish Language. 








CHARACTERS 


1" #S%& ' () *+, -. /0123456789: ;<=>7@ 
ABCDEF GHI JKLMNOPQRSTUVWXYZA@A~ ~ 
abcdefghijklmnopaqrstuvwxyze¢a.~ 


1" 4$%8? ()*+,-. /0123456789: + <=>2@ 
ABCDEFGHI JKLMNOPGRSTUVUXY ZEQA~_~ 
abcdefghi jk lmnoparstuvuxyzega~ 


"HS$Z8 ()*+, -, (0123456789: 5 <=>7@ 
ABCDEFGHIJKLMNOPQRSTUVUXYZABR* * 
abcdef ghi jklnnoparstuvuxyzena” 


1" #$%& ' ()*+,-. /0123456789: 
ABCDEFGHI JKLMNOPQRSTUVWEYZ 
abcdefghijkimnopqrstuvwxyz 


=> 7@ 


° 


\~ 


ane we 


1" #$%&? ()¥+,-. /0123456789; ;<=>7@ 
ABCDEFGHI JKLMNOPQRSTUVUXYZ;Nz7° _* 
abcdefghijklmnopqrstuvuxyz{ni}~ 


IHSZR? ()*+, -. (0123456789: 5 <=>74 
ABCDEFGHIIKLMNOPQRSTUVUXYZjNi° * 
abcdefghi jk lnnopgqrstuvuxyz{i}” 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
Spacing is set by the font also. 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size 


Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height __ 
Size (in dots) (in dots) [ 3 


ISO Substitution Characters: 
(Continued) 


ELITEU.CHARSETS.SYS 
(U.K. ENGLISH) 


This is the same as the Elite character font except that it 
contains ISO substitution characters for the United Kingdom. 





ELITEW.CHARSETS.SYS 


This is the same as the Elite character font except that it 
(SWEDISH/FINNISH) 


contains 1SO substitution characters for the Swedish and Finnish 
Languages. 


O 





Jan 84 
D-18 


CHARACTERS 


1S $%&' ()*+,-. /0123456789: 3 <=>7@ 
ABCDEFGHI JKLMNOPQRSTUVWXYZ[\]*_> 
abcdefghijklmnopqrstuvwxyz{ | }~ 


1" E$%&? ()¥+ ,-. /0123456789: :<=>7@ 
ABCDEFGHI JK LMNOPQRSTUVUXYZ(\]7_> 
abcdefghijkimnoparstuvuxyz{ | }~ 


INESAR? ()¥4, -. (0123456789: 5 <=>78 
ABCDEF GHIJKLMNOPQRSTUVUXYZ[\]7_* 
abcdef ghi jklunopgrstuviixy2{ | >” 


1" #%& ' ()*+, -. /0123456789: ; <=> 7E 


ABCDEFGHI JKLMNOPQRSTUVWXYZAOAU 6 


eee le 


abcdefghijklimnopaqrstuvwxyzadaii 


1" #63? ()¥+ ,-, /0123456789: :<=>7E 
ABCDEFGH I JKLMNOPQRSTUVUKY ZAORU_é 
abcdefghijklmnoparstuvuxyzadaui 


"HI" ()*+, ~. (0123456789: ; <=>7€ 
ABCDEFGHIJKLANOPORSTUVUKYZAGAU_é 
abcdef ghi jk lnnopqrstuvuxyzaoail 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 


the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is sone text printed in 
the selected font. The line 
spacing is set by the font also. 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 

FILE NAME 
Point Width Height _ 
Size (in dots) (in dots) a 


PICAF.CHARSETS.SYS 
(FRENCH) 


| This is the same as the Pica character font except that it 
contains 1SO substitution characters for the French Language. 


This is the same as the Pica character font except that © 
contains ISO substitution characters for the German Language. 


PICAG.CHARSETS.SYS 
(GERMAN) 
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CHARACTERS 


L"#$%&'()*¥+,-./0123456789:3<=>27a 
ABCDEFGHIJKLMNOPQRSTUVWXYZ°c§*_* 
abcdefghijklmnopqrstuvwxyzéue” 


1" #$%8? ()¥+,-./0123456789: + <=>2a 
ABCDEFGHI JKLMNOPORSTUVWXYZ°c§” _~ 
abcdefghi iklmoparstuvwxyzéue” 


1"#$%&" ()*+, -. /0123456789: ;<=>7a 
ABCDEF GHIJKLMNOPQRSTUVUXY2°C¢§* > 
abcdefghi jklmnopaqrs tuvuxyzéue” 


1"£$%&'()*+,~-./0123456789: 3 <=>2§ 
ABCDEFGHIJKLMNOPQRSTUVWXYZAOU~ * 
abcdefghijkimnopqrstuvwxyzaouR 


1" £$%8? ()*+,-. /0123456789: 3 <=>2§ 
ABCDEFGHIJKLMNOPQRSTUVWXYZAOQU” _~ 
abcdefghijkimnoparstuvwxyzaduR 


1 "£$9%8’ ()*+, -. /0123456789: ; <=> § 
ABCDEF GHIJKLMNOPQRSTUVUXYZAOU* _~ 
abcdef ghi jkimnopqrs tuvuxyza6uB 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here 18 some text printed in 
the selected font. The line 
spacing 18 set by the font also. 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here 1S some text printed in 
the selected font. The line 
Spacing is set by the font also. 
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D-1. 


CHARACTER FONT 
FILE NAME 


PICAN.CHARSETS.SYS 
(NORWEGIAN/ 
DANISH) 


PICAS.CHARSETS.SYS 
(SPANISH) 
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HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Celli Size Baseline ADDITIONAL INFORMATION 


Point Width Height - 
Size (in dots) (in dots) e 


This is the same as the Pica character font except that it 
contains {SO substitution characters for the Norwegian and 
Danish Languages. 





This is the same as the Pica character font except tha) 
contains ISO substitution characters for the Spanish Language 





CHARACTERS 


I"#$Z&'()*+,-./0123456789: 5 <=>7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZAGA~ —- 
abcdef ghijklmnopqrstuvwxyzega™ 


"HEYR? (1 *4+.~. /0123456789:5<=>7@ 
ABCDEEGHTJELMNOPORSTUVURY 2808" . 
abcdefghijklmnoparstuvwxyzega~ 


I"#SK8? ()*+, -./0123456 789: 5 <=> °@ 
ABCDEFGHIJKLMNOPORSTUVUXY ZABA* > 
abcdef ghi jkl mnopars tuvuxyzega~ 


I" #$%&'()*+,-./0123456789: 3< 
ABCDEFGHIJKLMNOPQRSTUVWXYZ | Ni 
abedefghijklmnoparstuvwxyz (fh 


¥ 
/® 


4° 
,~ 


1" #$7%87 (J *4+,-./0123456789: ; 
ABCDEFGHI JKLMNOPQRSTUVWXYZ} 
abcdefghijklmmopqrstuvwxyz{ 


=>?@ 


Neo 
pm 


"HSL ()*+,-./0123456789: 5 <=> 70 
ABCDEF GHIJKLMNOPQRSTUVUXYZ | NG °_ 
abcdefghijklmnopars tuvuxyz {f}” 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing 1s set by the font also. 
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D-1. 


CHARACTER FONT 
FILE NAME 


PICAU.CHARSETS.SYS 
(U.K. ENGLISH) 


PICAW.CHARSETS.SYS 
(SWEDISH/FINNISH) 
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HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 
Cell Size Baseline ADDITIONAL INFORMATION 


Point Width Height = 
Size {in dots) (in dots) { 


This is the same as the Pica character font except that it 
contains ISO substitution characters for the United Kingdom. 


This is the same as the Pica character font except that it & 
contains ISO substitution characters for the Swedish and Finnish 
Languages. 











CHARACTERS 


1"E$%%'()*4+,-./0123456789: 5<=>7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]7_~ 
abcdefghijklmnopqrstuvwxyz{ | }~ 


PE" $$x%&? (J) ¥+,-./0123456789::<=>2@ 
ABCDEFGHI JKLMNGPQRSTUVWKYZ[E\]7_~ 
abcdefghijklmmopaqrstuvwxyz{ | }~ 


1" E$%&’ ()*+, -. /0123456 789: 5 <=> 7@ 
ABCDEFGHIJIKLMNOPQRSTUVUXYZ [\] *_~ 
abcdefghijklmnopqrstuvuxyz{ | }~ 


1" #Q%&'()¥+,-./0123456789: 5 <=> 2K 
ABCDEFGHIJKLMNOPQRSTUVWXYZAOAU 4 
abcdefghijklmnopqrstuvwxyzadéati 


1"#O%&? ()¥+,-./0123456789: :<=>?E 
ABCDEFGHIJKLMNOPQRSTUVWKYZAOAU_é 
abcdefghijklimnopqrstuvwxyzadaui 


| *#0%&? ()*+, -. /0123456789: ; <=> 7E 


abcdef ghi jk lmnopars tuvuxyzadaii 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here 18 some text printed in 
the selected font. The line 
spacing 18 set by the font also. 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 
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D-1 


CHARACTER FONT 
FILE NAME 


Roman Extension Characters: 


ELITEX.CHARSETS.SYS 


LTITALX.CHARSETS.SYS 
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. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size Baseline ADDITIONAL INFORMATION 


Point Width Height pili, 
Size (in dots) (in dots) @& 


This character font is the Roman Extension to Elite. In 
the character samples, a black rectangle denotes undefined 
characters. 


CO 


This character font is the Roman Extension to Elite Italics. 
In the character samples, a black rectangle denotes undefined 
characters. 


O 


CHARACTERS 





EdUaEdUaSOUaESUA 1048 LoeA LOUEL 


SouaccuaeouacoUhiBAa ise CUEL 










an Bein; 20 


SOnuaeoUdeOUde SAT 51g ALOURZ 








ora AOL i SES 


BOUaEOUdEOUaESUAT DEat eALOURt 


a eh: j 


A FoF INNS were FA or aN Sey 
S Stic bas oUds SAT OAS wali COLT. 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height dilim, 
Size (in dots) (in dots) & 





SCRIPTX.CHARSETS.SYS 12 15 30 7 This character font is the Roman Extension to Script. In the 
character samples, a black rectangle denotes undefined 
characters. 

PICAX.CHARSETS.SYS 12 18 30 7 This character font is the Roman Extension to Pica. In the 
character samples, a black rectangle denotes undefined 
characters. 

8 12 23 5 


O 


6 9 19 5 
ROMX.CHARSETS.SYS 10 25 30 7 This character font is the Roman Extension to Roman. In 
the character samples, a black rectangle denotes undefined 
characters. : 
8 20 25 6 


0 
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CHARACTERS 







"et Nii; :0ems 


1E.OULCOUE GUATBR AL O2ALOUEL 


” “Ei: BcNnA; ié le) 


UASSIAIDALAIPeAIO 








rite 









a: A a ces 


n 


6OGAE 6UdROUaEOUR IBAA LORAIOUEIB 


8604660 aGOUSESUA 1 A4a i owed OUET 










F\Aee a 
£— 


Oude ouacoudesu AIO Haigw AIOUEIB 


Paawe ~ 
£— 


SGid éGUAddDASOUA TO MaipeAiOUE 










Nac si 





oNaoc si: 
BERR: 
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CHARACTER FONT 
FILE NAME 


Special Characters: 


MATH.CHARSETS.SYS 


OCRA.CHARSETS.SYS 


OCRB.CHARSETS.SYS 


PICALINE.CHARSETS.SYS 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size 


Point 
Size 


Width Height 
(in dots) 


Baseline 


(in dots) 





ADDITIONAL INFORMATION 


This font contains Mathematical symbols. 


This font is used with Optical! card readers. 


This font is used with Optical card readers. 


This is a Line drawing character font. 





CHARACTERS 


J/|§Vtof+=ITv= PEt ZF*SETEIOADINETY 
oP WE DAN 1LOKWUVETYETTEASXUC foT<]F 
oP WsEGAN 1 OkwuvonyGoTtEASxul [ete 


THE “4R' OC) xK+4--/010C345b789125<=>70 
ABCDEFGHIJKLMNOP@RSTUVUWXYZE\DAtd 
abcdef ghijklmnopgrstuvwxyzt|}i 


I'H#$Z&' Cd *+,-./0123456789: 7 <=>7a 
ABCDEFGHIJKLMNOPQRSTUVWXYZEC\I"_~ 
abcdefghijklmnopqrstuvwxyz{|}~ 


al Tot Te Hag Tusa 





ne@e 10 Cpue text wAivrtesd iV 
tne GeweYresd Apvtd tne wive 
OneyivrA if get Bu tne Apvt awidps 


Here is some text printed in 
the selected font. The line 
spacing is set by the font also. 


Here is some text printed in 
the selected font. The Line 
spacing is set by the font also. 


al le 
pes or, tel Tr ate 
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CHARACTER FONT 
FILE NAME 


Special Characters: 


PICAK.CHARSETS.SYS 


PICAKX.CHARSETS.SYS 


OCRBK.CHARSETS.SYS 


OCRBKX.CHARSETS.SYS 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size 


Point 
Size 


Width Height 
(in dots) 


Baseline 


(in dots) 





ADDITIONAL INFORMATION 


Katakana substitution 
with Katakana 8 extension 


Katakana substitution 
with Katakana 8 extension 


Katakana substitution 
with Katakana 8 extension 


CHARACTERS 


aBCERGHESRURNGEGRSE ROUSE [fT 28 


aad ae /O4 aetboueeetei. 8 
TK tMNOPORSTOVWAY 21 ¥] 
hijklmnoparstuvwxyz 


T'HSZR" ()*+,-. /0123456789: 3 <= 278 
ABCDEFGHIJKLMNOPORSTUVUXYZE¥] *_! 
abcdef ghi jkimnoparstuvuxyz{}~ 


shar LZE49 RAS AIT AUETBER TABU SEY Z 


srs ay~SADLANE PSII ACS 
py2ibe PRI NCIARIE AFEVIIFVLL-OIY” °F 


U"HSZS’ OC) *+,-./0123456789: 7 <=>70 
ABCDEFGHIJKLMNOPQRSTUVWXYZC¥] “fa 
abcdefghijklmnopqrstuvwxyz{}” 


oid," IPTOTAPIAY—PTOLANFITIFVARYA 
FIFEFIRRANC INEZ LATPIASIILLODIN eR 


Ueec gabe 0UG FSHk. Prenkeds A 


Here is some text printed . in 
the selected font. The 
Spacing 1S set by the font. 5S well. 


Here 15 some text printed in 
the selected font. The line 
spacing 1s set by the font as well. 


Here is some text printed in 
the selected font. The Line 
spacing is set by the font 
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CHARACTER FONT 
FILE NAME 


Special Characters: 


LNPR66K.CHARSETS.SYS 


LNPR66KX.CHARSETS.SYS 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size 


Point 
Size 


Width Height 
(in dots) 


Baseline 


{in dots) 





ADDITIONAL INFORMATION 


Katakana substitution 
with Katakana 8 extension 


Katakana substitution 
with Katakana 8 extension 


O 





CHARACTERS 


ABCGETGHETRLAINGP RRS TBOMRY 2 EF7°76 
pene rant tRcanspare ovunyz(43°°8 


' HS EXR? (84+, =~. /0123956789: 3<=>78 
ABCDEFGH I JKLMNOPORSTUVUXYZ[¥]*_@ 
abcdefghi jk lnnoparstuvuxyz{}~ 





PADIANF OF WD ACA 


«T3,° 724928 P BIH 
FUT ET IRE INE PVEPEG SEP IVI IOI" 2 
De 


biecangec kee tS AE PreRe CRE AES weil. 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) a 


Bar Codes: CODE 39™ ALPHANUMERIC BAR CODE* 


BAR39W14.CHARSETS.SYS 17.5 64 75 CODE39™, 14 mil minimum bar width 


BAR39W19.CHARSETS.SYS 18 28 45 CODE39™, 19 mil minimum bar width 


BAR39W25.CHARSETS.SYS 18 35 45 CODE39™, 25 mil minimum bar width 


| *Code 39 is a trademark of Interface 
Mechanism, Inc. 





UPCA20.CHARSETS.SYS 18 49 45 UPC-A, 20 mil minimum bar width 


UPCA25.CHARSETS.SYS 18 28 45 UPC-A, 25 mil minimum bar width 


UPCA35.CHARSETS.SYS 18 35 45 UPC-A, 35 mil minimum bar width 





Sept 84 
D-35.1 














CHARACTERS 


ACTA 
VTORUOT OC A A 
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D-1. HP 2680 Character Fonts Supplied With IFS/3000 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 


Size (in dots) (in dots) 


UPCE20.CHARSETS.SYS UPC-E, 20 mil minimum bar width 


UPCE25.CHARSETS.SYS UPC-E, 25 mil minimum bar width 


UPCE35.CHARSETS.SYS UPC-E, 35 mil minimum bar width 
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O 











CHARACTERS 





as 
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CHARACTER FONTS SUPPLIED WITH IFS/3000 


More About Bar Codes 


Several Bar Code character fonts have been 
provided for use on the HP Laser printing systems. 
These include different sizes of the Uniform 
Product Code (UPC) versions A and E for the HP 
2680, and Bar Code 39 for the HP 2680 and HP 
2688. These fonts were designed using the 
appropriate Code 39 and UPC specifications, and 
have been read with different bar code readers to 
verify readability. There is, however, no guarantee 
they will work with your particular readers.* 


Three widths have been provided for each of the 
HP 2680 bar code types as shown in Table D-2 
(one width for Bar Code 39 on the HP 2688). The 
nominal width for the narrow bar/space would be 
12, 14, 19, or 25 thousandths of an inch depending 
on the character set selected (Table D-2). 

To print a bar code string: 


1. Select the appropriate character font. 


2. Enter the desired string including guard bars. 


To print the character 0 with check digit (another 
0) and the’ guard bars, the character string would 
be: 

00% 


and would print as: 
UU Uh A 


If a bar height greater than the character height is 
required, the string may be printed multiple times, 
each pass doubling the normal height. For 
example: 


*Q0* 
£00* 


would print as: 


WM 


*HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE BAR CODE 
CHARACTER FONTS, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE OR ABILITY TO BE READ BY A 
PARTICULAR BAR CODE READER. Hewlett-Packard shall not be liable for errors contained therein or 
for incidental or consequential damages in connection with the furnishing, performance, or use of these fonts. 
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CHARACTER FONTS SUPPLIED WITH IFS/3000 


Bar Code 39®@ 
Table D-2. Bar Code Files 


Code 39® is a registered trademark of Interface 
Mechanisms, Inc. Nominal Width of 
Narrow Bar/Space 
(thousandths of inch) 


Bar Code Type 


For more details on the formats of Bar Code 39 
refer to Hewlett-Packard Application Brief No. 


406, "Use of the IPS 7000 to Print Bar Codes" HP 2680A 
See Table D-4 for the locations in the character UPCA20 Spe yoron 
fonts for the various Bar Code 39 characters UPCA 25 UP ersion 
on UPCA35 UPC Version A 
UPC VERSIONS A AND E UPCI20 UPC Version E 
UPCE25 UPC Version E 
For more information on the formats of the UPC UPCES5 UPC Version E 
Code, refer to: BAR39W14 | CODE 39® 
UPC SYMBOL SPECIFICATION |} BAR39W19]} CODE 39¢ 
Uniform Product Code Council, Inc. BAR39W251 CODE 39@ 
7051 Corporate Way, Suite 201 


Dayton, Ohio 45450 HP 2686 
BAR12W88 CODE 39® 
See Table D-3 for the locations in the character 
fonts for the various UPC version A and E 
characters. 
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D-3. HP 2680 UPC Character Locations 


UPC Character 


Left.Guard 
Right Guard 
Center Guard 








Character Font Character 
Version A Version E 










not applicable 


Odd Characters 












oOon7r nmr WN HO 
OMNI OMP WN HO 
ODMON OM PWN HH CO 


Even Characters 











OaoOnN a AWN - CO 
oeonmroam7modanap 
H—-—=—- ro mmMIdDUawV yp 
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D-4. HP 2680 and HP 2688 CODE 39™ 
Character Locations 










Code 39 Character Character Font Character 













* 





Guard 


0 0 
through through 

9 9 

A A 
through through 


Z 


CHARACTER FONTS SUPPLIED WITH IFS/3000 


THIS PAGE SHOULD BE BLANK 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) 


COURB88S.CHARSETS.SYS 


COURB88X.CHARSETS.SYS Roman 8 Extension 


COURI88S.CHARSETS.SYS 





COURI88X.CHARSETS.SYS Roman 8 Extension 


COURR88S.CHARSETS.SYS 


COURR88X.CHARSETS.SYS Roman 8 Extension 
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CHARACTERS 


PVESSEatE() e+,—./01234567893 -<=>?G 
ABCDEFGHIJ KLMNOPORSTUVWXYZ[\}3* ' 
abcdefghijklmnopqrstuvwxyz { | }~ 


Be 


BEIT *" "ute PR ceNhi coresrea 
ecuacouaecoudAl OFaig2aAiOUEIBOA 


E 
oua 
aDd{loooossuyYy bp 2% 2 2 cmt 


rods 


LUESS&'() *+,-./0123456789: 7 <=>?@ 
ABCDEFGHIJKLMNOPQORSTUVWXYZ[\]*_! 
abcdefghijklmnopgrstuvwxyz {| }~ 


AAEEEII °° uuEé FB CeNn;j ents rca 
eduaéduaeoudeoudAiGsxai vedi OuEi BoA 
AADAITOOOCSSSUY Y Pp -¢ 22 2 «mt 


I"#SZ&"() *+,-./0123456759: ;<=>?@ 
ABCDEFGHIJKLMNOPQORSTUVWAYZ[\]*_' 
abcdefghijklmnopgqrstuvwxyz {| }~ 


AAEEEII “uve BR ceNnjeneesrea 
Bees eee eg OTR LOUELBOA 
AaDdII6066SSUYYPpRM- i 32 2 «mt 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 


aifji of Meet | ee Pal rts ia oY 
ot a td ryygo aot Sovi 
PADOTS Om Biff a: Jot ivy ag 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 


ait of ber Fk: tows. OY 
E: Bisrtbiia ryy aot soyr 


PADOYO Of FLEf 4: ‘et TyvYj 4qj 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 







aigit off Fiver 9: riod OY 
OL fisipffid ryvgfo aor sovi 
PADOYO Of Ff a: Fort iyvy 4g 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) 


GOTHB88S.CHARSETS.SYS 


GOTHB88X.CHARSETS.SYS Roman 8 Extension 


GOTHI88S.CHARSETS.SYS 





GOTHI88X.CHARSETS.SYS Roman 8 Extension 


GOTHR88S.CHARSETS.SYS 


GOTHR88X.CHARSETS.SYS Roman 8 Extension 
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CHARACTERS 


1" #$%%? ()*+,-./0123456789: 3<=>?@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]* ‘ 
abcdefghijk]mnopaqrstuvwxyz{ | }~ 


AAEEEIL ~~" OL BRP Gch gok¥sf¢a 
€O0daéouaecouaeouA1 GAaT oeAi OUEITBOA 
Aabdd{i 16006S§ SUYYPp i: 222 mt 


"#828? ()*4, -./0123456789: ;<=>?0 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[ \]* ‘ 
abcdef ghi jkI mnopgrstuvwxyz{ |}~_ 


SAN 






AAEEE TE” vo£ °C ON j GRE¥S fea 
600 ab OU aeOU aEOUATOA AT ORAIOUETBOA 
AabdT 10006SSUY yPPR- 72? °«m>t 


1"#$%&’ ()*+,-./0123456789: ;<=>7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_ ‘ 
abcdefghi jkimnopqrstuvwxyz{ | }~ 


Pade ene en md Libre 
6d0aéduaedoudeouAT 0£ai geAiOUEIBOA 


Aabdi 16006SSUY bp —7 5S emyt 


Here is some text printed in 
the selected font. The line 
spacing is set by the font as well. 


tN OM Byer Biz Pwovyid oy 
Bisidgid 1yygo aor sovi 
HONG 6 Hifi a* Joi iyvg Ag isso 


Here 7s some text printed in 
the selected font. The line 
spacing is set by the font as well. 


on bur WW: A Le oY 
I fstoid 1 yV 0 aor soyr 
PADOVS O8 WL a? flor ry Aly isso 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font as well. 


aig of fyui iz aS. OY 
OL Isibyid 1yygo aol soyt 
PADOYO OM BM a° Boi yy Ag eisso 
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CHARACTER FONT 
FILE NAME 


PICAB88S.CHARSETS.SYS 


PICAB88X.CHARSETS.SYS 


PICAI88S.CHARSETS.SYS 


PICAI88X.CHARSETS.SYS 


PICAR88S.CHARSETS.SYS 


PICAR88X.CHARSETS.SYS 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 (cont.) 


Cell Size 


Point 
Size 


Width Height 
(in dots) 


Baseline 


(in dots) 





ADDITIONAL INFORMATION 


Roman 8 Extension 


Roman 8 Extension 


Roman 8 Extension 


CHARACTERS 


I"#$Z&'()¥#+,-./0123456789: 3<=>2@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] _! 
abedefghijklimnopqrstuvwxyz{|}~ 


AAEEETI "ute CoNA;j gak¥s fea 
6O0AE6SUaEd OUdG6UAISC HAL oRAIOURIBOA 
A&DGITTOOOSSSUY Yb pa 2 2 cmt 


IU#SZE'()¥+,—. /0123456789:3<=>7@ 
ABCDEFGHIJKIMNOPQRSTUVWXYZ[\]*_! 
abcdefghijklmnopgqrstuvwxyz{|}~ 


AEEEIT °° uur BB’ CeNnicurrss¢a 
6ndé Ouae OUdE OUAIO#A 1 aed i OUEI BOA 
ADATIOOOSSSUY YP pis 2 «mp + 


A 
é 
A 
Im#$Z&'()¥+,-. /0123456789:; 
ABCDEFGHIJKLMNOPQRSTUVWXYZ [ 
abedefghijklmnopqrstuvwxyz { 


AAEEETI- *" "ute BR ceNij guess rta 
EdnaéouaeouaéouAlOFAaioeAiOuEi BOA 
AaDAITOOOSSSUY y Pp Rs? 2 mt 


Here is some text printed in 
the selected font. The line 
Spacing is set by the font 


alfit of fpr Ik: ate ee OY 
OL Bsip9ia ryygo aor soyi 
PADOYO Off Ef 4: Qfot yyy Ag 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 


aly Of [bor IE. a OY 
OL FsiDfia Ly YEU aol sOYT 
ADOYO Of [Ef 42 for iy 4i 


Here is some text printed in 
the selected font. The line 
spacing is set by the font 
alg of fur whi i pRovgiia oY 
OT 9istp§iia ryvfu aor sort 
| are a | Bi 4° Jot ivy Ag 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) 


PRESB88S.CHARSETS.SYS 


PRESB88X.CHARSETS.SYS Roman 8 Extension 


PRESI88S.CHARSETS.SYS 





PRESI88X.CHARSETS.SYS Roman 8 Extension 


PRESR88S.CHARSETS.SYS 


PRESR88X.CHARSETS.SYS Roman 8 Extension 
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CHARACTERS 


IN#SSE" (e+, -. /0123456789: ;<=>?7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]“*_' 
abcdefghijklmnopqrstuvwxyz {| }~ 


LARA OA Oe er SAR ON 


AAERETI voe BR ccNaj cnevssea 
660d dae OUAEOUALDAAL OMALOUELROA 


AN 4A 


1"#S3&' ()¥+,-./0123456789: ;<=>?7@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]~_' 
abcdefghi jklmmnopqrstuvwxyz{ | }~ 


AAEEETI** "UU BP cena; at ygsyca 
Ed 46 du ae Oud eOUAI OFA L@RAIOUEIBOA 


AaDdITOOOSS SUY yb p22 ° cmt 


1"#S3&' ()%*+, -./0123456789: ;<=>7€@ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_! 
abcdefghijklmnopqrstuvwxyz{ | }~ 


AABREEIL "ube J ccNnj catys yea 
Oe uae ous ésOudiO#aiowAi OUET ROA 
AabDdai 16006 SsUvy bp: 22 «mot 


Here is some text printed in 
the selected font. The line 
spacing is set by the font as well. 


aifi Of yti Fe-g pyfoyffia oy 
OL Bisinffia tyygfo aol svi 
pADOYO Off Mi ae Jot ivy A «ssc 


Here is some text printed in 
the selected font. The line 
spacing is set by the font as well. 


aif Of Jburt Fj effoviie or 
Of Pistiofjid Iyyo_ 40f soyt 
ADOYO Off FE a¢ oi ivy] Al «tssv 


Here is some text printed in 
the selected font. The line 
spacing is set by the font as well. 


alfi og hur Fg p§fovgia ov 
OL Ftsiplia tyygo aol s0yvi 
pADOYO Off if a? Bot yy Ag «tssc 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseiine ADDITIONAL INFORMATION 
FILE NAME 


Point Width Height 
Size (in dots) (in dots) 


ROMPB888S.CHARSETS.SYS 


ROMPB88X.CHARSETS.SYS | | | Roman 8 Extension 


ROMPI88S.CHARSETS.SYS 





ROMPI88X.CHARSETS.SYS Roman 8 Extension 
ROMPR88S.CHARSETS.SYS 


ROMPR88X.CHARSETS.SYS Roman 8 Extension 
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CHARACTERS 















M#S%K'()*4,-./0123456789:;<=> °@ Here is some text printed in 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\I*_‘ the selected font. The line 
abcdefghijkImnopqrstuywxyz{|}~ spacing is set by the font as well. 
AAEREIi ~~” U08~ BB CoNajeneyg rea alli OM ByUi BCE povmia ov 
Cohacouaeou aso AIO Maioe AIOUEIBOA OF MsIDyld tyv9O Aoi sovi 
AaDdlOOOSSsUYy¥ bp —i342«mpt PADOYO Off Ii a* foi ivy Aq 
ASME )*+,-./012 3456789 2;<=>2@ Here is some text printed in 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]*_° the selected font. The line 
abcde f ghi jklmno parstuvwxyz{|}~ Spacing is set by the font as well. 
AAEBELI 00 PCN i 0€¥¥ 6 fea a Oo eo wy 1 pr 
COndE Ode ONaE I AIOE diow AiOU LiG a: B/sip , ee aU aol xO} > 
AGDATLOOO6SSUY 5b PEE 22.004 PADOYO OM IE a Qfo/ rv 4 
M#$%&?()*+,-./0123456789::<=>2@ Here is some text printed in 
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\}*_‘ the selected font. The line 
abcdef ghijkImnopgqrstuvwxyz{|}~ spacing is set by the font as well. 
AAEEEID UUE” BBP CoNaynerg sea alt OM Bui BUM PROVE ov 
Edddcouacoudési AiG HaiowAiOUEIBOA [ MSibMia WyYghO 401 sovi 
AaDdllOOOSSSUY yb p15 22 «mt bADOYO Off Hi «¢ BCI yyvgy An 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 (cont.) 


CHARACTER FONT Cell Size Baseline ADDITIONAL INFORMATION 


FILE NAME 
Point Width Height 


Size (in dots) (in dots) a, 


LINPR88S.CHARSETS.SYS 


LINPR88X.CHARSETS.SYS . Roman 8 Extension 


SCRPT88S.CHARSETS.SYS 


SCRPT88X.CHARSETS.SYS Roman 8 Extension 
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CHARACTERS 


I" H#B%B'C)*+, - ./0123456789: : <=>78 
ABCDEFGHI JKLMNOPQRSTUVWXYZ (\]*_! 
abcdefghi jklmnopqrstuvwxyz¢ | }~ 


AAEEEII ~~" “UGE Poco Nj enexs fea 
66046 6UaeOUaEOUA I OFA BAAIGUEIBOA 
Aadd i 160658 SU0V yp>pME- V2 2 2 aot 


IN#S3E" ( )¥*+,-./012345678925<= »?6 
ABCDEFGHI JKLMNOPORSTUVWXYZ1\ ]* 
abede fghijk&mnopqrstuvwxyz{|}~_ 


AAEEEIT ~~" Udé BP Conirij guevgrda 
€G0dEe 6Ude Gh COUN DARL O@ALOUE BOA 
AdddtT 1006 GSA aed —~Yhs Lent 





Here is some text printed jn 
the selected font. The line 
Spacing is set by the font as well. 


af OM Byct Big pgovgia oy 
HO! Bisfomid tyvpo aot govt 
MPADOYO OM Mim a? Bol ly AM utsso 


Herne 45 some text printed in 


the sekected font. The Line 
spacing 44 set by the font as well. 


Wyct Bey eyovaia ov 
id qi G aot svt 


* for Ty All 4tsha 
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D-5. HP 2688 Character Fonts Supplied With IFS/3000 













CHARACTER FONT 
FILE NAME 


ADDITIONAL INFORMATION 








Cell Size Baseline 





Point Width Height 












Size (in dots) (in dots) 





Special Characters: 


BIGNR88S.CHARSETS.SYS This character font contains only the digits 


0-9. 


© 


DRAWR88S.CHARSETS.SYS This is a line drawing character font. 


MATHR88S.CHARSETS.SYS This font contains mathematical symbols. 


C 
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CHARACTERS 





248 








ee HLT |-4H ante 
ie 
eel U ull q, 


J | 8Vto( +2 IPPSOE? 12245678 8Q Noo FET 
ECON Oc unyon BocEAbt hota. 
OBWSPEDAN LOKWUVETYETTEAEXUC [>T< 


Mery! yy 


neGe 10 Opue Text wWeivtesd iv 
TNE SOeweWtesd Apvtm TNE wive 
OnoWivrA 10 Det Bu tne Bove 
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D-5. HP 2688 Character Fonts Supplied With IFS/38000 


CHARACTER FONT Cell Si Baseli DDITI 
CHARACTE ize aseline ADDITIONAL INFORMATION 
Point Width Height 
Size (in dots) (in dots) a 
Bar Codes: CODE 39™ ALPHANUMERIC BAR CODE* 
B39W1288.CHARSETS.SYS 18 77 45 CODE39™, 12 mil minimum bar width 


*Code 39 is a trademark of Interface 
Mechanism, Inc. 
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Vetical Format Control 
(VEC) 


VFC is the printer industry standard for Vertical 
Format Control. A VFC allows a programmer to 
instruct the printer to skip to predetermined lines 
on a page with typically one or two commands 
instead of counting and printing a number of 
blank lines. The definition of the predetermined 
lines is contained in the VFC. 


The HP laser printer uses a VFC similar to that 
used for the HP 2608 printer except for the 
differences discussed in this appendix. A WFC for 
the HP laser printer contains 16 channels. Each 
channel performs a standard skip (or slew) function 
such as skip to top of next page, skip one line, skip 
to next quarter page, and so forth. The standard 
functions for each of the channels in a standard 
FFC are shown in table E-1. 


For the VFC in table E-1, the line position for 
each skip is based on a page with 60 potential print 
lines. For documents with other than 60 lines per 
page, the number of lines skipped varies with the 
length of the page. For example, the mid-point of 
a 60-line page is a different line number than the 
mid-point of an 80-line page. Compare the line 
positions in table E-2 which shows the standard 8 
line per inch VFC with 80 potential print lines per 
page to those in table E-1 which shows 6 lines per 
inch and 60 print lines per page. 
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VFC SPECIFICATIONS 


| Jan 84 
E-2 













LINE POSITIONS 
OF LOGICAL ONE* 


CHANNEL FUNCTION 







Slew to top of next form 0 










Slew to bottom of form 59 





Single space 0,1,2,... 










0,2,4,... 





Slew to next double space line 





Slew to triple space fine 0, 3,6,. 










0, 30 





Slew to half page line 






Slew to next quarter page line 0, 15, 30, 45 









Slew to next tenth line 0, 10, 20,...50 





Slew to bottom of form 59 





58 






Slew to one line previous to bottom of form 





Slew to one line previous to top of next form 65 






0 






Slew to top of next form 


Slew to next seventh line 







Slew to next sixth line 


Slew to next fifth line 







16 Slew to next fourth line 0, 4,8,... 56 


* Logical one is similar to the hole ina paper tape or destination point for that channel. 


NOTE: A ten-inch printed form area on an 11-inch page with 60 lines possible is assumed. 





VFC SPECIFICATIONS 


Table E-2. Standard Eight Line Per Inch Format 


CHANNEL FUNCTION LINE POSITIONS 
OF LOGICAL ONE* 


Slew to top of next form 0 

Slew to bottom of form 79 

Single space 0,1,2,...79 
Slew to next double space line 0,2,4,... 78 
Slew to triple space line 0,3,6,...77 
Slew to half page line 0, 40 

Slew to next quarter page line 0, 20, 40, 60 


Slew to next tenth fine 


0, 10, 20,...70 


Slew to bottom of form 79 

Slew to one line previous to bottom of form 78 

Slew to one line previous to top of next form 87 

Slew to top of next form 0 

Slew to next seventh line 0,7,14,...77 
Slew to next sixth line 0,6,12,...78 
Slew to next fifth line 0,5,10,...75 
Slew to next fourth line 0,4,8,...76 





Logical one is similar to the hole in a paper tape or destination point for that channel. 


NOTE: A ten-inch printed form area onan 11-inch page with 80 lines possible is assumed. 
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VFC SPECIFICATIONS 


Standard VFC 


With a standard VFC, you use IFS/3000’s Logical 
Page Menu to specify the number of print lines on 
the page. You can use the number of lines to 
specify the logical page height, or you can specify 
the page height and actual line height from which 
IFS/3000 calculates the number of print lines per 
page. IFS/3000 computes the number of lines to 
be skipped for each VFC channel and stores them 
in a VFC table. When a program issues a skip 
command using a VFC channel, the HP laser 
printer scans the VFC table to determine the line 
it should skip to. 


User Defined VFC 


The predefined skips in standard VFC channels 
may not fit your application. To accommodate 
unique applications, IFS/3000 allows you to define 
your own VFCs. With a user-defined VFC, each 
channel and its function is defined by you. 


To specify a user-defined VFC, you must first 
create and store your VFC file unnumbered, using 
an editor. The name of this file is then entered on 
the IFS/3000 Vertical Format Control Menu. 


Jan 84 
E-4 


VEC File Format 


A user-defined VFC file is an ASCII file 
containing 80-byte records. For each record, only 
the first 16 columns are significant. IFS/3000 
displays an error message when it encounters an 
unrecognized line in the VFC file. The HP laser 
printer ignores unrecognized VFC records. Refer to 
table E-3 for a sample VFC file format. 


Record 1 


Record 2 


Record 3 


Record 4 
Record 5 


Record 6 


Record m 


VFC SPECIFICATIONS 


Table E-3. Sample VFC File Format 


MARGIN = nn nn 

VFC,x,y,zzz x 
y 
ZZZ 

1011111100011111 

001 

0011 

00101 

01 m 





A number between 1 and 16 inclusive. Specifies position of left 
margin indentation for the HP 2608. Ignored by the HP Laser Printer. 


6,8,blank, or 0 specifies vertical spacing in lines per inch for the 

HP 2608, but not for the HP Laser Printer. Default is 6 lines per inch. 
If this is the only number, it is interpreted by the HP Laser Printer as 
number of lines per logical page. 

A number between 0 and 127 inclusive. Specifies number of lines 

in VFC. 


Comments to describe the VFC file. Ignored by the HP Laser Printer. 


A blank or 0 indicates a 0 (no-punch) and a non-blank indicates a 
1 (a punch). 


Number of lines in the VFC. Each line corresponds to a potential 
print line on the page. 
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VFC SPECIFICATIONS 


If you need to change from the default post-space 
mode to pre-space mode, use a carriage control 
value of "A". Use carriage control "@" to change 
back to post-space mode. 


In general, a VFC file begins with an optional 
record which sets the left margin. While this 
record is meaningful to the HP 2608, the HP laser 
printer ignores the MARGIN record, if present. To 
set the left margin for the HP laser printer, you 
use the IFS/3000 Logical Page Menu. 


The VFC record, which is required, follows the 
MARGIN record. The VFC record gives the 
number of lines per inch and the number of 
potential print lines on the page. 


In the VFC record, the only parameter which is 
significant to the HP laser printer is the number of 
potential print lines per page. The other 
parameters have significance only for the HP 
2608. Vertical line spacing for the HP laser 
printer is set on the IFS/3000 Logical Page Menu. 
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Table E-4 illustrates the number of lines per page 
used by the HP laser printer as a result of various 
VFC record formats. If the number of lines 
parameter is 0, the number used for lines per page 
is 11 times the value of the lines per inch 
parameter. If there is only one number following 
"VFC", the HP laser printer interprets it as the 
number of lines per page, not the lines per inch. If 
neither lines per inch nor lines per page is 
specified, the HP laser printer defaults to 66 lines 
per page. In any case, the number of lines before 
the first print line and after the last print line are 
set as close as possible to the unprintable area of 
the HP laser printer. 


Table E-4. Sample VFC Record Formats 


Number of Lines 
| Per Page 





VFC8,0 88 
VFC 6,0 66 
VFC 11,9 121 
VFC 66 ; 66 






V.FC 






As shown in table E-1, the subsequent records are 
a paper tape image defining the lines to be skipped 
to for each channel. Column | represents the line 
to be skipped to when a program issues a skip to 
channe! 1; column 2 represents channel 2, and so 
forth, through channel 16. To define the function 
for each channel, locate the column for the desired 
channel and put a non-blank or non-zero 
character (usually a 1) in the row representing the 
line to be skipped to. 


These records can be used to define the number of 
lines to be skipped before the first print line. If 
zero records are skipped before the first print line, 
a skip to channel 11 (one line before the first print 
line) does not function correctly. 


VFC SPECIFICATIONS 


For a standard line printer, there are usually three 
lines skipped before the first print line and three 
lines after the last print line, with 60 potential 
print lines per page. To define this VFC, you 
specify 66 lines on a logical page with the Logical 
Page Menu. Using the VFC Selection Menu, you 
select the standard VFC option and specify three 
lines before and three lines after printing. 
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VFC SPECIFICATIONS 


Carriage Control 


The first byte of each output record can be used as 
the carriage control for that line of print. 


>FILEPRINTOUT ; DEV=LP3;CCTL 


With the "CCTL" specified in the file statement, 
the first byte of each output record will be used to 
determine carriage control. 


The jiaser printer assumes that channel 3 is for 
single spacing and all carriage returns will generate 
a channel 3 call. A double space carriage control 
("0") will generate a channel 4 call which will 


normally slew paper to the next odd line 
(0,1,3,5...). A triple space carriage control ("-") will 
generate a channel 5 call which will normally slew 
paper to the next triple space line (0,3,6...). A page 
eject ("1") will select VFC channel 1. 


If you need to space a set number of lines, use 
“42nn carriage control where nn is the number of 
lines to space. 


Some sample carriage control characters are listed below. 


OCTAL ASCII CARRIAGE LASER PRINTER 
CODE SYMBOL ACTION CHANNEL CALLED 
%40 so Single line feed 3 

%53 me" Suppress line feed 

%55 "2" Triple line feed 5 

%60 "oO" Double line feed 4 

%6 1 "yu" Logical page eject 1 
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SAMPLE PROGRAMS 
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COBOL 


NN SO OS TT 80 


00001000 
00002000 
00003000 
00004000 
00005000 
00006000 
00007000 
00008000 
00009000 
00010000 
00011000 
00012000 
00013000 
00014000 
00015000 
00016000 
00017000 
00018000 
00019000 
00020000 
00021000 
00022000 
00023000 
00024000 
00025000 
00026000 
00027000 
00028000 
00029000 
00030000 
00031000 
00032000 
00033000 
00034000 
00035000 
00036000 
00037000 
00038000 
00039060 
00040000 
00041000 
00042000 
00043000 
00044000 
00045000 
00046000 
00047000 
00048000 
00049000 
00050000 
00051000 
00052000 
60053000 


$CONTROL USLINIT 


- 2 logical pages: 
#0 at 90 degrees, 
#1 at 90 degrees, 


- 2 character sets: 
#0 Elite. 
#1 Elite Italics. 


- Standard 3/3 VFC. 


eR KM HN HN HN NHN MN KH HHH HE KN HB 


Identification Division. 


Program-Id. 
Author. 
Date-Written. 
Remarks. 


Environment Division. 
Configuration Section. 
Source-Computer. 
Object-Computer. 


Input-Output Section. 
File-Control. 


Select PrintFile assign 
access 


Data Division. 
File Section. 


FD PrintFile 


This sample program illustrates the callin 
several of the iFS/3000 intrinsics from COBOL. 
opens a SpoolFile indicated by the file equation: 


-FILE SPOOLOUT ;DEV=PP; ENV=MEMOENV 


Quarterly Report Program. 


sequences for 
The program 


The environment MEMOENV has the following characteristics: 


no form, initially inactive. 
letterhead form, initally active. 


QREPORT. 


J. §. 

July 1982. 

This program was written to illustrate 
several. of the IFS/3000 intrinsics. 


HP-3000. 
HP-3000. 


to "SPOOLOUT" 
is sequential. 


label records are omitted. 


Ol PrintFileRec 


Working-Storage Section. 


77 ~=Language 
77 XPosition 


pic X(132). 


pic $9(4 


(4) comp. 
pic X(16). 
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00054000 
00055000 
00056000 
00057000 
00058000 
00059000 
OcO60000 
00061000 
00062000 
00063000 
00064000 
00065000 
00066000 
00067000 
00068000 
00069000 
00070000 
00071000 
00072000 
00073000 
00074000 
00075000 
00076000 
00076100 
00077C00 
00078000 
000739000 
00080000 
00081000 
00082000 
00083000 
00084000 
00085000 
00086000 
00087000 
00088000 
00089000 
00090000 
00091000 
00092000 
00093000 
00094000 
00095000 
00096000 
00097000 
00098000 
000399000 
00100000 
00101000 
00102000 
00103000 
00104000 
00105000 
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ANE AEN SSS SS SS ng 
SIN 


MAE AAAS A SSN SSS 


77 


YPosition 
PrimaryFont 
SecondaryFont 
AreaLen 
FieldName 
SubFieldNum 
Info 

InfoLen 
OutputDev 

XLoc 

YLoc 
LogPageNum 
FigureName 
FigureFileName 
RasterFileName 
Height 
Rotation 

Units 
RasterNumber 
PositionMode 
ErrorMsg 
ErrorMsgLen 
MsgLen 
DisplayErrorNum 


ComArea. 

03 IFSStatus 
03 ErrorNum 
03 ErrorParml 
03 ErrorParm2 
03) MsgFileNum 
03 Filler 


Procedure Division. 


Main-Process Section. 


Mission-Control. 


Open Output, PrintFile. 


Perform Generate-Report. 


Close PrintFile. 
Stop Run. 


Generate-Report Section. 


Quarterly-Report. 


pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 
pic 


pic 
pic 
pic 
pic 
pic 
pic 


occu 


Nee Oe ee 
— . 


OO 0 0 0 O- 0 ODO 2 OO 00 00 tO 


KMANKNONW YN KKK KN KY KY KN Y) Oe 
Ua C0 me mn ee EB eee DNR een pe 
~PPOLSHAAMAMOAIBS HAY AUA~TBAAD 


+ tlt Net Net Nese ae Natl eel Set nel! one! Nea Nee Nene! Ne? 


v_~ 


comp. 
comp. 
comp. 


comp. 


comp. 


comp. 
comp. 
comp. 


comp. 
comp. 
comp. 
comp. 


comp. 


comp. 


comp. 
comp. 
comp. 
comp. 
comp. 
comp 


95 times. 


00106000 
00107000 
00108000 
00103000 
00110000 
00111000 
00112000 
00113000 
00114000 
00115000 
00116000 
00117000 
00118000 
00119000 
00120000 
00121000 
00122000 
00123000 
00124000 
00125000 
00126000 
00127000 
00128000 
00129000 
00130000 
00131000 
00132000 
00133000 
00134000 
60135000 
00136000 
00137000 
00138000 
00139000 
00140000 
00141000 
00142000 
00143000 
00144000 
00145000 
00146000 
00147000 
00148000 
00149000 
00150000 
00151000 
00152000 
00153000 
00154000 
00155000 
00156000 
00157000 
00158000 


Initialize the IFS/3000 intrinsics. 


Move 2000 to AreaLen. 

Move Zero to Language. 

Move "2680A " to OutputDev. 

Call "“PINITDEVICE” using ComéArea, 
AreaLen, 
Language, 
PrintFile, 
OutputDev. 

Perform Check-For-Error. 


Now write to the four fields. 
* 


All fields have only 1 subfield. 


Move -1 to SubFieldNum. 


Move "FROM “ to FieldName. 

Move " Profit Monitor" to Info. 

Move 20 to InfoLen. 

Call “PWRITEFIELD" using ComArea, 
FieldName, 
SubFieldNum, 
Info, 
InfoLen. 

Perform Check-For-Error. 


Move "TO " to FieldName. 

Move " 

Move 27 to InfoLen. 

Call “PWRITEFIELD" using ComArea, 
FieldName, 
SubFieldNum, 
Info, 
InfoLlen. 

Perform Check-For-Error. 


Move "DATE " to FieldName. 

Move " August 1, 1982" to Info. 

Move 24 to InfoLen. 

Call “PWRITEFIELD"” using ComArea, 
FieldName, 
SubFieldNum, 
Info, 
InfoLlen. 

Perform Check-For-Error. 


Move “SUBJECT " to FieldName. 


All Regional Managers” to Info. 
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00153000 Move " Last Quarter’s Sales“ to Info. 


00160000 Move 34 to InfoLen. 

00161000 Call "“PWRITEFIELD" using ComArea, 

00162000 FieldName, 

00163000 SubFieldNum, 

00164000 Info, 

00165000 InfoLen. 

00166000 Perform Check-For-Error. 

00167000 

00168006 * 

00169000 * Now move the pen: 1 inch over, 4 inches down. 

00170000 x 

00171000 Move 180 to XLoc. 

00172000 Move 720 to YLoc. 

00173000 Call "“PMOVEPENABS" using Comarea, 

00174000 XLoc, 

00175000 YLoc. 

00176000 Perfo:m Check-For-Error. 

00177000 

00178000 x 

00179000 * Switch the primary font to italics. 

60180000 * 

00181000 Move 1 to PrimaryFont. 

00182000 

00183000 * Secondary font remains unchanged. 

00184000 

00185000 Move -1 to SecondaryFont. 

0018600C 

00187000 Call "“PUSEFONT" using ComArea, 

00188000 PrimaryFont , 

00189000 SecondaryFont. 

00190000 Perform Check-For-Error. 

00191000 

00192000 x 

00193000 * Now write out some text in the new font. 

00194000 x 

00195000 Move Spaces to Info. 

00196000 Move “See page 2 for last quarter’s sales figures." 

00197000 to Info. 

00198000 Write PrintFileRec From Info; Invalid Key Stop Run. 

00199000 

00200000 x 

00201000 * Now, activate logical page O (no form) and deactivate 

00202006 * logical page 1 (letterhead form) and then skip to the 

00203000 x new page. 

00204000 x 

00205000 Move Zero to LogPageNum. 

00206000 Call "“PACTIVATEPAGE" using ComArea, 

00207000 LogPageNum. 

00208000 Perform Check-For-Error. 

00209000 

00210000 Move 1 to LogPageNum. 

00211000 Call “PDEACTIVATEPAGE" using ComéArea, 

002120006 LogPageNum. 
Jan 84 


F-6 


00213000 
00214000 
00215000 
00216000 
00217000 
00218000 
002139000 
00220000 
00221000 
00222000 
00223000 
00224000 
00225000 
00226000 
00227000 
00228000 
00229000 
00230000 
00231000 
00232000 
00233000 
00234000 
00235000 
00236000 
00237000 
00238000 
00239000 
60240000 
00241000 
00242000 
00243000 
00244000 
00245000 
00246000 
00247000 
00248000 
00249000 
00250000 
00251000 
00252000 
00253000 
00254000 
00255000 
00256000 
00257000 
00258000 
00259006 
00260000 
00261000 
00262000 
00263000 
00264000 


* 


Perform Check-For-Error. 


Call 
Perfo 


“PNEWPAGE" using ComArea. 
rm Check-For-Error. 


* Now convert the figure created by DSG/3000 into a 
raster image. 


* 


* 


ue MN HM 


Move 
Move 
Move 


“QTRSALES “ to FigureFileName. 
“SECOND QUARTER “ to FigureName. 
"RONDQTR “ to RasterFileName. 


Indicate inches. 


Move 
Move 
Move 
Call 


Perfo 


Now load 


1 to Units. 

"6.0 " to Height. 

90 to Rotation. 

“PCONVERTFIGUREA" using ComArea, 
FigureFileName, 
FigureName, 
RasterFileName, 
OutputDev, 
Height, 
Units, 
Rotation. 

rm Check-For-Error. 


the image as #17, print it at a position elative 


to the Upper-left corner of the iogical page, then delete 


Move 
Call 


Perfo 


1.5 Inch 
Move 
Move 

Indicate 
Move 
Call 


Perfo 


Call 


17 to RasterNumber. 

"PLOADRASTER" using ComArea, 
RasterFileName, 
RasterNumber. 

rm Check-For-Error. 


es right; 2.0 inches down. 

"1.5 " to XPosition. 

"2.0 " to YPosition. 

relative positioning. 

O to PositionMode. 

“PPRINTRASTERA” using ComArea, 
RasterNumber, 
XPosition, 
YPosition, 
Units, 
PositionMode. 

rm Check-For-Error. 


“PDELETERASTER" using ComArea, 
RasterNumber. 


it. 
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00265000 
00266000 
00267000 
00268000 
00269000 
00270000 
00271000 
00272000 
00273000 
00274000 
00275000 
00276000 
00277000 
00278000 
00279000 
00279100 
00279200 
00280000 
00281000 
00282000 
00283000 
00284000 
00285000 
00286000 
00287000 
00288000 
00289000 
00290000 
00291000 
00292000 
00293000 


DATA AREA IS 
CPU TIME 


* 
* 


* 


Perform Check-For-Error. 
Generate-Exit. 


Exit. 
Check-For-Error Section. 


routine checks the ComArea’s IFSStatus to see if an error 
occurred. If so, then PERRMSG is called, the error is 
reported, and the program terminates. 


If IFSStatus of ComArea Not = O then 


Move Spaces to DisplayErrorNum 

Move ErrorNum of ComArea to DisplayErrorNum 
Display "(IFS Error ", DisplayErrorNum, "jy" 
Move Spaces to ErrorMsg 

Move 80 to ErrorMsgLen 

Move Zero to MsgLen 

Call “PERRMSG" using ComArea, 


ErrorMsg, 
ErrorMsgLen, 
MsgLen 
Display ErrorMsg 
Stop Run. 


Check-Exit. 
Exit. 


2005017 WORDS. 
= 0:00:04. 


WALL TIME = 0:00: 


18. 
END COBOL/3000 COMPILATION. NO ERRORS. NO WARNINGS. 
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BASIC 


3 


Program to generate a Quarterly report 


This sample program illustrates the calling sequences for 
several of the IFS/3000 intrinsics from BASIC. 

The program opens a SpoolFile with an environment with 
the following characteristics: 


-~ 2 logical pages: 

#0 at 90 degrees, no form, initially inactive. 

#1 at 90 degrees, letterhead form, initially active. 
- 2 character sets: 

#0 Elite. 

#1 Elite Italics. 


~ Standard 3/3 VFC. 


FOO OO IIR OI IOI I IOI III III II IOI II KIO KI IKK 


Variable Definition Equivalent SPL Type 
Cl ComArea Logical Array 
D1$ DeviceClass Byte Array 
F1$ FormalDesignator Byte Array 
F2 File System ErrNum Integer 
L1 Language Integer 
Xl XLocation Integer 
Y1 YLocation Integer 
X2 XPosition Real 
¥2 YPosition Real 
Pl PrimaryFont Integer 
P2 SecondaryFont Integer 
Si SpoolFileNum Integer 
Al AreaLen Integer 
F2$ FieldName Byte Array 
$2 SubFieldNum Integer 
D2$ Data Byte Array 
D2 DataLength Integer 
O1$ OutputDevice Byte Array 
L2 LogPageNum Integer 
Nis FigureName Byte Array 
N2$ FigureFileName Byte Array 
R1$ RasterFileName Byte Array 
Hi Height Real 
Ril Rotation Integer 
Ul Units Integer 
R2 RasterNumber Integer 
M1 PositionMode Integer 
E1$ ErrorString Byte Array 
M2 MessageLength Integer 
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530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
6390 
7Q0 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
$00 
910 
920 
930 
940 
350 
960 
970 
980 
990 
1000 
1010 
1020 
1030 
1040 


REM L3 ErrorStringLen Integer 
REM Z1 SpoolFileOpenErr Integer 
Ree Z1i$ SpoolFileOpenString Byte Array 
REM 
REM 
REM 
INTEGER C1[2000} 
INTEGER F2 JLo, X1,Y¥1, 
REM 
DIM D1$[15],F1$[9], 
DIM R1$[35],E1$[80}, 
REM 
FILES * 
REM 
REM 
REM First, Open the SpoolFile 
REM 
LET Fig$="“SPOOLOUT 
LET D1$="PP;ENV=MEMOENV " 
LET Z1$="FILE "+Fi$+" -DEV="4D1$ 
SYSTEM Z1,Z1$ 
IF Zi<>0O THEN DO 
PRINT "Cannot issue file equation for SpoolFile. 
PRINT “System error number = ":Z1 
STOP 
DOEND 
ASSIGN F1i$,1,Z1 
IF Z1<>8 THEN DO 
PRINT “Cannot open SpooiFile. 
PRINT “System error number = ":Z1 
STOP 
DOEND 
REM 
REM Get the file system number using standard function SFN. 
REM 
LET S1i=SFN(1) 
REM 
REM Next, Initialize the IFS/3000 intrinsics. 
REM 
LET A1l=2000 
LET Ll=1 
LET O1$="2680A" 
CALL PINITDEVICE(C1[*],A1,L1,S$1,01$) 
GOSUB 2040 
REM 
REM Now Write to the four fields 
REM 
REM All fields have only 1 subfield. 
LET S2=-1 
LET F2$="FROM" 
LET D2$=" Profit Monitor" 


1,P2,S1,A1,S2,D2,L2,R1,U1,R2,M1,M2,L3,Z1 


P 
F2siiel, D2$[127] ,O1$[6] ,Ni$[35] ,N2$[35] 
Z1$[80} 


Jan 84 
F-10 


a ee re oe ee So 
NO ed ear ee oe el 
OWOMANBONPW 
O0D000000 


LET D2=20 

CALL PWRITEFIELD(C1L[*],F2$,S2,D2$ ,D2) 
GOSUB 2040 

REM 

LET F2$="TO" 

LET D2$=" All Regional Managers" 
LET D2=27 

CALL PWRITEFIELD(C1[*],F2$,S2,D2$ ,D2) 
GOSUB 2040 

REM 

LET F2$="DATE" 

LET D2$=" August 1, 1982" 

LET D2=24 

CALL PWRITEFIELD(C1[*],F2$,S2,D2$,D2) 
GOSUB 2040 

REM 

LET F2$="SUBJECT"” 

LET D2$=" Last Quarter’s Sales" 
LET D2=34 

CALL PWRITEFIELD(C1[*],F2$,S2,D2$ ,D2) 
GOSUB 2040 

REM 

REM 

REM Now move the pen. 

REM 

REM Go Over 1 inch. 

LET X1=180 

REM Go down 4 inches. 

LET Y1l=720 

CALL PMOVEPENABS(C1i[*],X1,Y1) 

GOSUB 2040 

REM 

Ren Switch the Primary font to Italics. 
LET Pl=l1 

REM The secondary font remains unchanged. 
LET P2=-1 

CALL PUSEFONT(C1i[*],P1,P2) 

GOSUB 2040 

REM 

REM Now write out some text in the new font. 


1460 REM 


1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 


PRaNT #1:"See page 2 for last quarter’s sales figures.” 
REM Now, activate logical pase 0 (no form) and deactivate 
REM logical page 1 (letter 

REM 

LET L2=0 

CALL PACTIVATEPAGE(C1[*],L2) 

GOSUB 2040 

LET L2=1 

CALL PDEACTIVATEPAGE (C1[*],L2) 


ead form) and skip to the new page. 
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GOSUB 2040 
REM 


CALL PNEWPAGE(C1[*]) 
GOSUB 2040 
REM 
REM Now convert the figure created with DSG/3000 into a raster 
REM image. 
REM 
LET N2$="QTRSALES” 
LET N1$="SECOND QUARTER" 
LET Rig="R2NDQTR" 
REM specify inches 
LET Ul=1 
REM 6 inches high 
LET H1=6 
REM 90 degree rotation 
LET Ri=90 
CALL PCONVERTFIGURE(C1[*],N2$,N1$,R1$,01$,H1,U1,R1) 
GOSUB 2040 
REM 
REM Now load the image as #17, print it at a position relative 
REM to the Upper-left corner of the logical page, and then 
REM delete it. 
REM 
LET R2=17 
CALL PLOADRASTER(C1[*] ,R1$,R2} 
GOSUB 2040 
REM 
REM 1.5 inches to the right 
LET X2=1.5 
REM 2.0 inches down the page 
LET Y2=2 
REM indicate relative positioning 
LET M1=0 
CALL PPRINTRASTER(C1L[*],R2,X2,Y2,U1,M1} 
GOSUB 2040 
REM 
CALL PDELETERASTER(C1[*],R2) 
GOSUB 2040 
REM 
REM Done. 
END 
REM 
REM 
REM 
REM 
REM 
Ree Subroutine CHECK FOR ERROR 
E 
REM This routine checks the ComArea’s Status to see if an error 
REM occurred If so, then PERRMSG is called, the error is 
REM reported and the program terminates. 
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NINN NMNNNN NADA PD 
NN RR RRR RRR Re O 
rPODOMONDUPWNrH OW 
OdD0000000 0000 


Cif{i] is Status of the ComArea, 
REM C1{2] is the Error number. 
1}=0 THEN RETURN 


REM An error/warning has occurred. 
M 

PRINT “(IFS Error ";Ci[2];")" 

REM L3 is a dummy variable here. 
LET L3=0 

CALL PERRMSG(C1[*],E1$,L3,M2) 
PRINT E1$ 

STOP 
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00001000 
00002000 
00003000 
00004000 
00005000 
00006000 
00007000 
00008000 
00009000 
00010000 
00011000 
00012000 
00013000 
00014000 
00015000 
00016000 
00017000 
00018000 
00019000 
00020000 
00021000 
60022000 
00023000 
00024000 
00025000 
00026000 
00027000 
00028000 
00029000 
00030000 
00031000 
06032000 
00033000 
00034000 
00035000 
00036000 
00037000 
00038000 
00039000 
00040000 
00041000 
00042000 
00043000 
00044000 
00045000 
00046000 
00047000 
00048000 
00049000 
00050060 
00051000 
00052000 


Jan 84 
F-14 


S$CONTROL USLINIT 
C 


DQ ANIAIOQAIAIIIINIIAAIAAIAGINNAIAINNANANDNNANIANO 


program QUARTERLYREPORT 


~ 2 logical pages: 


#0 at 90 degrees, 
#1 at 90 degrees, 


- 2 character sets: 


#0 Elite. 
#1 Elite Italics. 


- Standard 3/3 VFC. 


no form, 
letterhead form, 


This sample program illustrates the calling sequences for several 
of the IFS/3000 intrinsics from FORTRAN. h 
SpoolFile with an environment with the following characteristics: 


e program opens a 


initially inactive. 
initially active. 


Note that all error messages are written to logical unit number 5, 


which must be equated with a file or device; e.g. 
:FILE FINOS=$STDLIST 
external CHECKFORERROR 
system intrinsic FOPEN, FCLOSE, FCHECK, FWRITE, TERMINATE, 
&PINITDEVICE, PERRMSG, PWRITEFIELD, PMOVEPENABS, PMOVEPENREL, 
&PUSEFONT, PACTIVATEPAGE, PDEACTIVATEPAGE, PNEWPAGE 


&PCONVERTFIGURE, PLOADRASTER, PPRINTRASTER, PDELETERASTER 


characterxX16 DeviceClass 


characterxl DevClassEquiv(16) 


equivalence 
characterx255 CharArray 
characterx9 FormalDesig 
integer FSErr 

logical ComArea(2000) 
integer Status 

integer ErrorNum 
integer ErrorParml 
integer ErrorParm2 
integer MsgFileNum 
equivalence (ComArea 
equivalence 


equivalence (ComArea 


(DeviceClass, 


(1) 
(ComArea(2), 
(3) 


DevClassEquiv) 


Status) 
ErrorNum) 
ErrorParml ) 


00053000 
00054000 
00055000 
00056000 
00057000 
00058000 
00059000 
00060000 
00061000 
00062000 
00063000 
000640060 
00065000 
00066000 
00067000 
00068000 
00069000 
00070000 
00071000 
00072000 
00073000 
00074000 
00075000 
00076000 
60077000 
00078000 
00079000 


00081000 
00082000 
00083000 
00084000 
00085000 
00086000 
00087000 
00088000 
00089000 
00090000 
00091000 
00092000 
06093000 
00094000 
00095000 
00096000 
00097000 
00098000 
00099000 
00100000 
00101000 
00102000 
00103000 
00104000 
00105000 


QAOONQ O 


ano 


equivalence (ComArea(4}, ErrorParm2 } 
equivalence (ComArea(5), MsgFileNum) 
integer Language 

real XPosition 

real YPosition 

unteger PrimaryFont 

integer SecondaryFont 
integer SpoolFileNum 
integer OldFileNum 

integer AreaLen 
characterxki6 FieldName 
integer SubFieidNum 
characterk255 Data 

integer DataLen 

character*6 OutputDev 
integer XLoc 

integer YLoc 

integer Logra eNum 
characterki7 FigureName 
characterx36 FigureFileName 
characterxX36 RasterFileName 
real Height 

integer Rotation 

integer Units 

integer RasterNumber 
integer PositionMode 


First, Open the Spoolfile. 


FormalDesig = "SPOOLOUT “ 
DeviceClass = "PP;ENV=MEMOENV" 
DevClassEquiv(15) = %15C 


FOPTIONS are: CCTL, Undefined, Formal, 


AOPION are: Write Only. 
SpoolFileNum = FOPEN (FormalDesig, 


& \4ZBO04L\, 
& \1\, 
& 3 
& DeviceClass} 
if (.cC.}) 10, 20, 10 
FOPEN error. 
write (5,10000) 
format(1X, “Cannot Open SpoolFile.") 
call FCHECK (SpoolFileNum, FSErr) 
write (5,20000) FSErr 
format(1X, “(FSERR ", 13, ")") 
call TERMINATE 


continue 


ASCIT, 


New file. 
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ooo 
Ooo 
he 


bbe EO OOO 
ODNOUBUWUNEF OW OND 
CODSDDCDOCCOCO 
CODSDCKDCCCDCO 
CODSDDD0DDOCSO 


000 
000 


eo lotwloalalolelelolorelolololelele) 


00127000 
00128000 
00129000 
00130000 
00131000 
90132000 
00133000 
00134000 
00135000 
00136000 
00137000 
00138000 
00139000 
00140000 
00141000 
00142000 
00143000 
00144000 
00145000 
00146000 
00147000 
00148000 
00149000 
00150000 
00151000 
00152000 
00153000 
00154000 
00155000 
00156000 
00157000 
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OO0GD AAN 


DO ANDANAND 


OOaA0NND 


Associate logical unit number 11 with the SpoolFileNum 
call FSET(11, SpoolFileNum, OldFileNum) 


Next, Initialize the IFS/3000 intrinsics. 


AreaLen = 2000 

parguage = 2 

QutputDev = "26804 " 

call PINITDEVICE (ComArea,AreaLen, Language ,SpoolFileNum, OutputDev) 
call CHECKFORERROR (Status, ErrorNum) 


Now Write to the four fields. 


All Fields have only 1 subfield. 
SubFieldNum = -1 


FieldName = "FROM " 

Data = " Profit Monitor" 

DataLen = 20 

call PWRITEFIELD (ComArea,Fieldname,SubFieldNum,Data,DataLen) 
call CHECKFORERROR (Status, ErrorNum) 


FieldName = "TO “ 

Data = " All Regional Managers" 

DataLen = 27 

call PWRITEFIELD (ComArea,FieldName ,SubFieldNum,Data,DataLen) 
call CHECKFORERROR (Status, ErrorNum) 


FieldName = "DATE " 

Data = " August 1, 1982" 

DataLen = 24 

call PWRITEFIELD (ComArea, FieldName ,SubFieldNum,Data,DataLen) 
call CHECKFORERROR (Status, ErrorNum) 


FieldName = “SUBJECT " 
Data = " 

DataLen = 34 

call PWRITEFIELD (ComArea, FieldName ,SubFieldNum,Data,DataLen) 
call CHECKFORERRCR (Status, ErrorNum) 


Last Quarter’s Sales" 


Now move the pen. 


1 inch over 
XLoc = 180 


00158000 
00159000 
00160000 
00161000 
00162000 
00163000 
00164000 
00165000 
00166000 
00167000 
00168000 
00169000 
00170000 
00171000 
00172000 
00173000 
00174000 
00175000 
00176000 
00177000 
00178000 
00179000 
00180000 
00181000 
00182000 
00183000 


oQooooo 
ooooo 
Abe Re be 
09 00 00 

~~ 

fo] 

len) 

Oo 


00190000 
00191000 
00192000 
00193000 
00194000 
00195000 
00196000 
00197000 
00198000 
00199000 
00200000 
00201000 
00202000 
00203000 
00204000 
00205000 
00206000 
00207000 
00208000 
00209000 


‘o) 


oO AOQAQ0N0 


0000 


ANQAANANDwW OAANQNO 


QO 


QaQNQG0N0D 


4 inches down. 
YLoc = 720 
call PMOVEPENABS (ComArea, XLoc, 
call CHECKFORERROR (Status, 


YLoc) 
ErrorNum) 


Switch The Primary Font to Italics. 


PrimaryrFont = l 

SecondaryFont remains unchanged. 
Secon ea ye ON = - 
call PUSEFONT (CcomArea, PrimaryFont, 


call CHECKFORERROR (Status, ErrorNum) 
Now write out some text in the new font. 


write (11, 30000) 
format (1X 


Now, activate logical page 0 (no form) and deactivate logical 
page 1 (letterhead form) and skip to the new page. 


LogPageNum = 
cail ACT TVATE PAGE (ComArea, 


LogPageNum) 
call CHECKFORERROR (Status, 


ErrorNum) 


LogPageNum = 1 


call PDEACTIVATEPAGE (ComArea, LogPageNum) 
call CHECKFORERROR (Status, ErrorNumy 

call PNEWPAGE (ComArea) 

call CHECKFORERROR (Status, ErrorNum) 


SecondaryFont ) 


"See page 2 for last quarter’s sales figures."} 


Now Convert the figure created with DSG/3000 into a raster 


image. 


FigureFileName = “QTRSALES " 

FigureName = "SECOND QUARTER “ 

RasterFileName = "R2NDQTR " 

Indicate inches. 

Units = 1 

Height = 6.0 

Rotation = 90 

call PCONVERTFIGURE (ComArea, 
RasterFileName, OutputDev, 


FigureFileName, 
Height, 


FigureName, 


Units. 


Rotation) 


far 


anes 


00210000 
00211000 
00212000 
00213000 
00214000 
00215000 
00216000 
00217000 


oo°ooo 
ooooo 
RONRIDN 
RON NR ee 
Noe © © oo 


00223000 
00224000 
00225000 
00226000 
00227000 
00228000 
00229000 
00230000 
00231000 
00232000 
00233000 
00234000 
00235000 
00236000 
00237000 
00238000 
00239000 
00240000 
00241000 
00243000 
00244000 
00245000 
00246000 
00247000 
00248000 
00249000 
00250000 
00251000 
00252000 
00253000 
00254000 
00255000 

256000 


00260000 
00261000 
00262000 


Jan &4 
F-18 


OO ANdA00 ‘@) ag OOOAND 


oO 


QOMOABAND 


C 
C 


call CHECKFORERROR (Status, ErrorNum) 


Now Load the image as #17, print it at a position relative to 
the Upper-left corner of the logical page, and then delete it. 


RasterNumber = 17 
call PLOADRASTER (ComArea, RasierFilename, RasterNumber ) 
call CHECKFORERROR (Status, ErrorNum) 


Place it 1.5 inches to the right, 2.0 inches down the page. 
XPosition = 1.5 
YPosition = 2.0 

relative positioning. 
PositionMode = 0 


goat PPRINTRASTER (ComArea, RasterNumber, XPosition, YPosition, 


Units, PositionMode) 
call CHECKFORERROR (Status, ErrorNum) 


call PDELETERASTER (ComArea, RasterNumber) 
call CHECKFORERROR (Status, ErrorNum) 
Finally, close the spoolfile. 


call FCLOSE (SpoolFileNum, 0, 0) 


stop 
end . 
subroutine CHECKFORERROR (Status, ErrorNum) 


integer Status 
integer ErrorNum 


This routine checks the ComArea’s Status to see if an error 
occurred. 
and the program terminates. 


If so, then PERRMSG is called, the error is reported, 


characterxl ErrorMsg(80) 
integer ArrayLen 
integer MsgLen 

/80x" "/ 


data ErrorMsg 
if (Status .EQ. 0) return 

An Error/Warning occurred. 
write (5,40000}) ErrorNum 


40000 format(1X, "(IFS Error ", 14, ")") 


00263000 
00264000 
00265000 
00266000 
00267000 
00268000 


ArrayLen = 80 

call PERRMSG (ComArea, 
display ErrorMsg 

call TERMINATE 

return 

end 


ErrorMsg, 


ArrayLen, 


MsgLen}) 
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00001000 
00002000 
00003000 
00004000 
00005000 
00006000 
00007000 
00008000 
00009000 
00010000 
00011000 
00012000 
6001300 
0001400 
0001500 
0001600 
0001700 
00018000 
00019000 
00020000 
00021000 
00022000 
00023000 
00024000 
00025000 
00026000 
00027000 
00028000 
00029000 
00030000 
00031000 
00032000 
00033000 
000340006 
00035060 
00036000 
00037000 
00038000 
00039000 
00040000 
00041000 
00042000 
00043000 
00044000 
00045000 
00046000 
00047000 
00048000 
00049000 
00050000 
00051000 
00052000 
00053000 
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00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00000 
00004 
00004 
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SPL 


$CONTROL USLINIT 


be 


eq 


gin << Quarterly Report Program >> 


This sample program illustrates the calling sequences for several 
The program opens a | 
SpoolFile with an environment with the following characteristics: 


of the IFS/3000 intrinsics from SPL. 


- 2 logical pages: 
#0 at 90 degrees, 
#1 at 90 degrees, 


no form, 
letterhead form, 


- 2 character sets: 
#0 Elite. 
#1 Elite Italics. 
- Standard 3/3 VFC. 


>> 


uate 
cMaxComArealen 


cs 
cStatusOk 


byte array DeviceClass (0: 
logical array LogArray(0: 
byie array CharArray (xX) = 
byte array FormalDesignator 
integer FSErr; 

logical array ComArea(0:cMa 
define Status ComArea 
define ErrorNum 
define ErrorParml 
define ErrorParm2 
define MsgFileNum 
integer Language; 
real XPositilon; 
real YPosition,; 
integer PrimaryFont; 

integer SecondaryFont; 
integer SpoolFileNum; 
integer AreaLen; 

byte array FieldName(0:15); 
integer SubFieldNum; 

byte array Data(0:255); 
integer DataLen; 

byte array OutputDev(0:5) := 
integer XLoc; 

integer YLoc; 


ComArea 


wenn i 
©> 
o 
3 
p> 
s 
a 
is] 
tt tt tt He HES 


"2680A "; 


initially inactive. 
initially active. 


00054000 00004 1 integer LogPageNum; 

00055600 00004 i byte array FigureName(0:16); 

00056000 00004 I byte array FigureFileName(0:35) ; 

00057000 00004 1 byte array RasterFileName(0:35); 

00058000 00004 1 real Height; 

00059000 00004 1 integer Rotation; 

00060000 00004 1 integer Units; 

00061000 00004 1 integer RasterNumber ; 

00062000 00004 1 integer PositionMode, 

00063000 00004 1 byte array AsciiNum(0:9), 

00064000 00004 1 logical array L’AsciiNum(*) = AsciiNum,; 

00065000 60004 1 byte array Msg(0:79), 

00066000 00004 1 logical array L’Msg(X)} = Msg; 

00067000 00004 1 integer NumChar; 

600068000 00004 1 

00069000 00004 1 intrinsic 

00670000 00004 1 FOPEN, FCLOSE, FCHECK, FWRITE, TERMINATE, ASCII, PRINT, 
00071000 00004 1 PINITDEVICE, PERRMSG, PWRITEFIELD, PMOVEPENABS, PMOVEPENREL, 
60072000 00004 1 PUSEFONT, PACTIVATEPAGE, PDEACTIVATEPAGE, PNEWPAGE , PCONVERTFIGURE , 
00073000 00004 1 PLOADRASTER, PPRINTRASTER, PDELETERASTER,; 

00074000 00004 1 

00076000 006004 1 procedure CHECK’FOR’ ERROR; 

00077000 00000 1 

00078000 00000 1 «< 

00079000 00000 1 << This routine checks the ComArea’s Status to see if an error 
00080000 06000 1 << occurred. If so, then PERRMSG is called, the error is reported, 
00081000 90000 1 << and the program terminates. 

00082000 00000 1 «< >> 

00083000 00000 1 

00084000 00000 1 begin <<CHECK’FOR’ERROR>> 

00085000 00000 2 byte array ErrorMsg(0:79); 

00086000 00000 2 integer ArrayLen; 

00087000 060000 2 integer MsgLen; 

00088000 00000 2 if Status <> cStatusOk then 

00088000 00011 2 begin <<Get error/warning message>> 

60090000 00011 3 move Msg := "(IFS Error ",; 

00091000 00026 3 PRINT (LMS 9 -1li, 4320); 

00092000 00032 3 NumChar := ASCII (ErrorNum, 10, AsciiNum) ; 
00093000 00041 3 PRINT (L’AsciiNum, -NumChar, 4320); 

00094000 00046 3 move Msg := "j)"; 

00095000 00055 3 PRINT ({L’Msg, -1, 0); 

00096000 00061 3 ArrayLen := 80; 

00097000 00063 3 PERRMSG (ComArea, ErrorMsg, ArrayLen, MsgLlen}; 
00098000 00070 3 move Msg := ErrorMsg, (MsgLen); 

00099000 00074 3 PRINT (L’Msg, -Msglen, 0}; 

00100000 00100 3 TERMINATE ; 

00101000 00101 3 end; <<Get error/warning message>> 

00102000 oO0101 2 end; <<CHECK’ FOR’ ERROR>> 

00103000 00000 1 

00105000 00000 1 

00106000 000¢0 1 «< 

00107000 00000 1 << First, Open the Spoolfile. 
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00121000 
00122000 
00123000 
00124000 
00125000 
00126000 
00127000 
00128000 
00129000 
00130000 
00131000 
00132000 
00133000 
00134000 
00135000 
00136000 
00137000 
00138000 
00139000 
00140000 
00141000 
00142000 
00143000 
00144000 
00145000 
00146000 
00147000 
00148000 
00149000 
00150000 
00151000 
00152000 
00153000 
00154000 
00155000 
00156000 
00157000 
00158000 
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<< >> 


move FormalDesignator := "SPOOLOUT "; 
move DeviceClass := "“PP;ENV=MEMOENV": 
DeviceClass(14) := %15; << Required to terminate string properly >> 


SpoolFileNum := FOPEN (FormalDesi nator, 
4604, <<CCTL, Undef, Formal, ASCII, New>> 
1, <<Write only>> 
, <<Default RecSize>> 
DeviceClass); 
if <> then 
begin <<FOPEN error>> 
move Msg := "Cannot Open SpoolFile” 
PRINT (L’Msg, -21, 0); 
FCHECK (SpoolFileNum, ate 
NumChar := ASCII {Fser 10, AsciiNum) ; 
move Msg := "(FSER ; 
PRINT (L’Msg, -7, 1926) 
PRINT (L’ AsciiNu -NumChar, 4320); 
move Msg := "Jj": 
PRINT (L’Msg, -i, 0}; 
TERMINATE: 
end; <<FOPEN error>> 
<< 
<< Next, Initialize the IFS/3000 intrinsics. 
<< >> 
AreaLen := cMaxComAreaLen: 
banguage := cSPL; 
PINITDEVICE (ComArea, AreaLen, Language, SpoolFileNum, OutputDev); 
CHECK’ FOR’ ERROR: 
<< 
<< Now Write to the four fields. 
<< >> 
SubFieldNum := -1; <<All fields have only 1 subfield>> 
move FieldName := "FROM ".: 
move Data := " Profit Monitor" 
DataLen := 20; 
PWRITEFIELD (ComArea, Fieldname, SubFieldNum, Data, DataLen); 
CHECK ’FOR’ERROR, 
move FieldName := "TO ": 
move Data := " All "Regional Managers" 
DataLen := 27, 
PWRITEFIELD (ComArea, FieldName, SubFieldNum, Data, DataLlen}; 


CHECK FOR’ ERROR; 


00159000 
00160000 
00161000 
00162000 
00163000 
00164000 
00165000 
00166000 
00167000 
00168000 
00169000 
00170000 
00171000 
00172000 
00173000 
00174000 
00175000 
00176000 
00177000 


9000 
0000 
1000 
2000 
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Oo 
oO 
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2Q 


ooooo0o0o0000 000 
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00191000 
00192000 
00193000 
00194000 
00195000 
00196000 
00197000 
00198000 
00199000 
00200000 
00201000 
00202000 
00203000 
00204000 
00205000 
00206000 
00207000 
00208000 
00209000 
00210000 
00211000 
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move FieldName := "DATE "“"; 


move Data := August 1, 1982"; 

DataLen := 24; 

PWRITEFIELD {ComArea, FieldName, SubFieldNum, Data, Datalen); 
CHECK’ FOR’ ERROR ; 

move FieldName := "SUBJECT "; 

move Data := " Last Quarter’s Sales" 

DataLen := 34; 

PWRITEFIELD (ComArea, FieldName, SubFieldNum, Data, Dataten); 


CHECK’ FOR ERROR, 


c< 

<< Now move the pen. 

<< >> 

XLoc := 180; <<1 Inch>> 

YLoc := 720; <<4 Inches>> 

PMOVEPENABS (ComArea, XLoc, YLoc}; 

CHECK’ FOR’ ERROR; 

K< 

<< Switch The Primary Font to Italics. 

K< >> 

PrimaryFont := 1; 

SecondaryFont := -1; <<Remains unchanged>> 
PUSEF ONT (ComArea , PrimaryFont, SecondaryFont}; 
CHECK’ FOR’ ERROR; 

Kc 

<< Now write out some text in the new font. 
«< >> 


move CharArray := 
DataLen := 45; 
FWRITE (SpoolFileNum, 
if <> then 
begin <<FWRITE error>> 
move Msg := "FWRITE failed. 
PRINT (L’Msg, -14, ; 
TERMINATE ; 
end; <<FWRITE error>> 


"See page 2 for last quarter’s sales figures." 


LogArray, -DataLen, 0); 


<< 


<< Now, activate logical page 0 {no form} and deactivate logical page 
«< (letterhead form} and skip to the new page. 
«< >> 


LogPageNum := 0; 
PACTIVATEPAGE (ComArea, 


LogPageNum) ; 
CHECK FOR’ ERROR; 
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00212000 
00213000 
00214000 
00215000 
00216000 
00217000 
00218000 
00219000 
00220000 
00221000 
00222000 
00223000 
00224000 
00225000 
00226000 
00227000 
00228000 
00229000 
00230000 
00231000 
00232000 
00233000 
00234000 
00235000 
00236000 
00237000 
00238000 
00239000 
00240000 
00241000 
00242000 
00243000 
00244000 
00245000 
00246000 
00247000 
00248000 
00249000 
00250000 
00251000 
00252000 
00253000 
00254000 
00255000 
00256000 
00257000 
00258000 

PRIMARY 


00532 
00534 
00537 
00540 
00540 
00542 
00543 
00543 
00543 
00543 
00543 
00543 
00556 
00574 
00614 
00616 
00620 
00622 
00626 
00633 
00634 
00634 
00634 
00634 
00634 
00634 
00634 
00636 
00642 


00643. 


00643 
00645 
00647 
00651 
00656 
00660 
00661 
00661 
00664 
00665 
00665 
00665 
00665 
00665 
00665 
00670 
00670 
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NO. ERRORS=0000; 


PROCESSOR TIME=0:00:05; 
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end. 
DB STORAGE=%045: 


bo eae eNum := 1; 
PDEACTIVATE PAGE 
CHECK FOR’ ERROR: 


PNEWPAGE (ComArea) ; 
CHECK FOR ERROR ; 


<< 


<< Now Convert the figure created with DSG/3000 into a raster image. 
<< >> 


(ComArea, LogPageNum) ; 


move FigureFileName := "QTRSALES "; 
move FigureName := “SECOND QUARTER "; <<Terminated with a blank>> 
move RasterFileName -:= "R2NDQTR ".: <<Terminated with a blank>> 


Units := 1; <<Inches>> 

Height := 6.0: 

Rotation := 90; 

PCONVERTFIGURE (ComArea, FigureFileName, Fi 
OutputDev, Height, Units, R 

CHECK ’FOR’ERROR; 


«< 
<< Now Load the image as #17, print it at a position relative to the 


<< Upper-left corner of the logical page, and then delete it. 
«< >> 


gureName , RasterFileName, 
) 


ation); 


RasterNumber := 17: 

PLOADRASTER (ComArea, RasterFilename, RasterNumber),; 

CHECK ’FOR’ ERROR: 

XPosition := 1.5; <<Inches to the right>> 

YPosition := 2.0; <<Inches down the page>> 

PositionMode -:= Q; <<Relative>> 

PPRINTRASTER (ComArea, RasterNumber, XPosition, YPosition, Units, 


PositionMode},; 
CHECK 'FOR’'ERROR: 


PDELETERASTER (ComArea, 
CHECK FOR ERROR ; 


<< 


<< Finally, 
«< >> 


FCLOSE (SpoolFileNum, 0, 0); 


RasterNumber);: 


close the spoolfile. 


<<Quarterly Report Prédgram>> 
SECONDARY DB STORAGE =404503 
NO. WARNINGS=0000 

ELAPSED TIME=0:00:34 


WWWNINNNMNNN DAD RRR RRR Rhee 


33. 
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$USLINIT, STANDARD LEVEL 
program Quarterly Report 


- 2 logical pages: 


- 2 character sets: 
#0 Elite. 


- Standard 3/3 VFC. 


AN RN poten poten pan, poten patm, poten, patn, pol, patrn, patun, poten poten, patton, patron, 


cStatusOk 


type 
SmalliInteger 
ComAreaRec 


DevArray 


const 
cDevParm 


type 

agType 
charArrayType 
LogArrayType 
LogicalRec 


$PAGES$ 


#0 at 90 degrees, 
#1 at 90 degrees, 


#1 Elite Italics. 


Pascal 


"HP3000°S 


(input, output); 


This sample program illustrates the calling sequences for several 
of the IFS/3000 intrinsics from Pascal. The program opens a 
SpoolFile with an environment with the following characteristics: 


no form, initially inactive. 
letterhead form, initially active. 


2; 
chr(13); 
0; 


-32768. .32767; 


record 
Status : SmalliInteger;: 
ErrorNum : Smallinteger; 
ErrParml : SmalliInteger; 
ErrParm2 : SmalliInteger; 


MsgFileNum: SmalliInteger; 
Reserved : array [1..1995] 
of Smallinteger; 
end; 
packed array [1..15] of char; 


DevArray [’PP;ENV=MEMOENV’ ,cCR]; 


(ByteAddr, Woda aot: 
packed array [ .80] of char; 
array {1 J of SmallInteger; 
record 
dummybyte : char; {To keep data aligned} 
case AddrTag : TagType of 
ByteAddr : (CharArray : DoeAtractyeey 
4 WordAddr : (LogArray : LogArrayType) 
end; 
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.000 


.000 
.000 
.000 
. 000 
.Q00 
.0a0 
.000 


64.000 
65.000 
66.000 
67.000 
68.000 
69.000 
70.000 
71 

72 

73 
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.000 

.000 

.000 
74.000 
75.000 
76.000 
77.000 
78.000 
79.000 
80.000 
81.000 
82 000 
3.000 
84.000 
85.000 
86.000 
87.000 
88.000 
89.000 
90.000 
91.000 
2.000 
93.000 
94.000 
95.000 
96.000 
97.000 


99.000 
.000 
.000 
.000 
.000 
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Var 


DeviceClass 
FormalDesignator 


FSErr 
ComArea 
Language 
XPosition 
YPosition 


PrimaryFont 
SecondaryFont 


TextArray 


SpoolFileNum 


AreaLen 
FieldName 


SubFieldNum 


Data 
DataLen 
OutputDev 
XLoc 

YLoc 


LogPageNum 
FigureName 


FigureFileName 
RasterFileName 


Height 
Rotation 
Units 


RasterNumber 
PositionMode 


function 

procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 
procedure 


$PAGES 


FOPEN 
FCLOSE ; 
FCHECK; 
FWRITE ; 
TERMINATE ; 
PINITDEVICE; 
PERRMSG; 
PWRITEFIELD; 
PMOVEPENABS ; 
PUSEFONT ; 

PMOVE PENREL ; 
PACTIVATEPAGE ; 
PDEACTIVATEPAGE ; 
PNEWPAGE ; 
PCONVERTFIGURE ; 
PLOADRASTER :; 
PPRINTRASTER: 
PDELETERASTER; 


SmallInteger; 


DevArray; 

packed array [1. 
SmalliInteger; 
ComAreaRec ; 
SmalliInteger; 
real; 

real, 
SmallInteger; 
Smallinteger; 
LogicalRec; 
SmalliInteger; 
SmalilInteger: 
packed array [1. 
Smallinteger; 
packed array [1l1. 
smalliInteger; 
packed array [1. 
SmalliInteger; 
SmalliInteger; 
SmalilInteger; 
packed array [1.. 
packed array [1.. 
packed array [1.. 
real; 
SmalliInteger; 
SmalliInteger ; 
SmalliInteger; 
SmalliInteger; 


intrinsic; 
intrinsic, 
intrinsic; 
intrinsic; 
intrinsic; 
intrinsic; 
intrinsic; 
inirinsic; 
intrinsic; 
intrinsic; 
intrinsic; 
intrinsic; 
intrinsic; 
intrinsic: 
intrinsic; 
intrinsic; 
intrinsic; 
intrinsic; 


.9] of char; 
.16] of char; 
.256] of char. 
.6] of char; 
16] of char 
35] of char 
35] of char; 
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procedure CHECK _FOR_ERROR; 


This routine checks the ComArea’s Status to see if an error 


occurred. If so, then PERRMSG is called, the error is reported, 


{ 
{ 
and the program terminates. 


var 
ErrorMsg : packed array [1..80] of char; 
ArrayLen : SmalliInteger; 
MsgLen : SmalliInteger; 


begin {CHECK FOR ERROR} 
with ComArea do 
begin {with} 
if Status <> cStatusOk then 
begin {Get error/warning message} 
writeln (output, ’(IFS Error °, ErrorNum:1, °)’); 
ArrayLen := 80; 
PERRMSG (ComArea, ErrorMsg, ArrayLen, MsgLen); 
writeln (output, ErrorMsg:MsgLen) ; 
TERMINATE ; 
end; {Get error/warning message} 
end; {with} 
end; {CHECK _FOR_ERROR} 


$PAGES 
begin {Quarterly Report} 
{ 
pirst, Open the Spoolfile. 


FormalDesignator := *SPOOLOUT ’; 
DeviceClass := cDevParm,; 
SpoolFileNum := FOPEN (FormalDesignator 


octal(’604'), {CCTL, Undef, Formal, ASCII, 


1, {Write only} 
; {Default RecSize} 
DeviceClass); 

if ccode <> CCE then 

begin {FOPEN error} 
writeln(output, “Cannot Open Spoolfile’); 
FCHECK (SpoolFileNum, FSErr); 
writeln(output, “(FSERR ', FSErr:1, °)’); 
TERMINATE ; 

end; {FOPEN error} 


New} 
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next, Initialize the IFS/3000 intrinsics. 


AreaLen := 2000; 
Language := 5; 
OutputDev := ‘26804 ’; 

PINITDEVICE (ComArea, AreaLen, Language, SpoolFileNum, OutputDev) ; 
CHECK _FOR_ERROR; 


{ 
{ Now Write to the four fields. 


{ } 

SubFieldNum := -1; {All fields have only 1 subfield} 
FieldName := ’FROM ’; 

Data := ’ Profit Monitor’; 


DataLen := 20; 
PWRITEFIELD (ComArea, Fieldname, SubFieldNum, Data, DataLen); 
CHECK_FOR_ERROR; 


FieldName := ‘TO ’,; 

Data := ’ All Regional Managers’; 

DataLen := 27; 

PWRITEFIELD (ComArea, FieldName, SubFieldNum, Data, DataLen); 
CHECK_FOR_ERROR; 


FieldName := ‘DATE ’; 

Data := ’ August 1, 1982’; 

DataLen := 24; 

PWRITEFIELD (ComArea, FieldName, SubFieldNum, Data, DataLen); 
CHECK _FOR_ERROR; 


FieldName :.= ’SUBJECT ’; 

Data := ’ Last Quarter’’s Sales’; 

DataLen := 34; , 

PWRITEFIELD (ComArea, FieldName, SubFieldNum, Data, DataLen); 
CHECK_FOR_ERROR;; 


{ Now move the pen. 


{ } 
XLoc := 180; {1 Inch} 
YLoc := 720; {4 Inches} 


PMOVEPENABS (ComArea, XLoc, YLoc}); 
CHECK _FOR_ERROR; 


{ 
ywitch The Primary Font to Italics. 
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PrimaryFont := 1; 
SecondaryFont := h {Remains unchanged} 
PUSEFONT (ComArea, PrimaryFont, SecondaryFont} ; 
CHECK_FOR_ERROR; 


{ Now write out some text in the new font. 


with rere toed do 


begin {with 
ddrTag :=  ByteAddr: 
CharArray := 'See page 2 for last quarter’’s sales figures.’ ; 
DataLen := 45; 
AddrTag := WordAddr; 
FWRITE (SpoolFileNum, LogArray, -DataLen, Q); 
if ccode <> CCE then 
begin {FWRITE error} 
writeln{(output, ‘FWRITE failed.’); 


TERMINATE ; 
end; {FWRITE error} 
end; {with} 


Now, activate logical page O (no form) and deactivate logical page 
; (letterhead form) and skip to the new page. 


Lograg geNum := 0; 
TIVATE PAGE (ComArea, LogPageNum) ; 
CHECK FOR ERROR: 


Loar eNum := 1; 

ACTIVATEPAGE (ComArea, LogPageNum) ; 
CHECK FOR ERROR: 

PNEWPAGE (ComArea} ; 

CHECK_FOR_ERROR; 


{ how Convert the figure created with DSG/3000 into a raster image. 


FigureFileName := ’QTRSALES '; 

FigureName := *SECOND QUARTER - {Terminated with a blank} 
RasterFileName := ‘R2NDQTR '; {Terminated with a blank} 
Units := 1; {Inches} 

Height := 6.0; 


Rotation := 90; 

PCONVERTFIGURE (ComArea, FigureFileName, FigureName, RasterFileName, 
OutputDev, Height, Units, Rotation); 

CHECK FOR_ERROR; 
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Now Load the image as #17, print it at a position relative to the 
ppper-tert corner of the logical page, and then delete it. 


RasterNumber := 17. 
PLOADRASTER (ComArea, RasterFilename, RasterNumber) ; 
CHECK FOR ERROR; 


XPosition 1.5; {Inches to the right} 

YPosition 2.0; {Inches down the page} 

PositionMode := Q; {Relative} 

PPRINTRASTER (ComArea, RasterNumber, XPosition, YPosition, Units, 
PositionMode}); 

CHECK_FOR_ ERROR; 


PDELETERASTER (ComArea, RasterNumber)-; 
CHECK _FOR_ERROR; 


{ 
Finally, close the spoolfile. 


FCLOSE (SpoolFileNum, QO, Q); 


end. {Quarterly Report} 


NUMBER OF ERRORS = 0 NUMBER OF WARNINGS = 0 
PROCESSOR TIME 0: 0:12 ELAPSED TIME 0: 0:26 
NUMBER OF LINES = 287 LINES/MINUTE = 1435.0 
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101 


102 


104 


106 


107 


108 


109 


110 


111 


ERROR MESSAGE 


Internal error: Expected to write record 
type nnn, not nnn, (PSPERR 101) 


Internal error: (PSPERR 102) 
Assertion nnn failed in procedure 
XXX. 


Internal error: bad orientation 
request: nnn (PSPERR 104) 


Internal error: bad low ASCII 
number: nnn (PSPERR 106) 


Internal error: bad high ASCII 
number: nnn (PSPERR 107) 


Can’t write to the environment file. 
(FSERR nnn) 

Form names must begin with 

a letter. 

This program doesn’t support this 


terminal, since V/3000 doesn’t. 


This program doesn’t support this 
device, since V/3000 doesn’t. 


MEANING 


Probably a bad environment file or 
possibly an internal software error, 
not under user control. 

























Internal software error, not under 
user control. 





Internal software error, not under 
user control. 





Internal software error, not under 
user control. 





Internal software error, not under. 
user control. 


FWRITEDIR failed. 


A nonalphabetic character 
begins the form name. 


Terminal is not supported by 


V/3000. 


Terminal is not supported by 
V/3000. 


ACTION 


Write down error message and 
contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Refer to the file system error number 
for more information and possible 
action. 


Check the form name. 


Consult the V/3000 Reference 
manual (P/N 32209-90001 ) for 
supported terminals. 


Consult the V/3000 Reference 
manual (P/N 32209-90001 ) for 
supported terminals. 
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201 This file is not an environment file. 
203 Internal error: Bad record type: 
Expected.nnn, not nnn. (PSPERR 203) 
204 Bad env file: bad pointer nnn. 
(PSPERR 204) 
206 Bad env file: default meas. sys. 
bad in phys page. (PSPERR 206) 
207 Bad env file: # recs inconsistent 
in free header. (PSPERR 207) 
208 _— Bad env file: inconsistent log page # 
in LP desc. (PSPERR 208) 
209 __—sCiBad env file: bad orientation in log 
page desc. (PSPERR 209) 
210 ~=Bad env file: bad units in log page 
desc. (PSPERR 210) 
211 Bad env file: expected to find 
compiled phys page. (PSPERR 210) 
212 Bad env file: cset # out of range 
in phys pg desc. (PSPERR 212) 
216 Bad env file: expected compiled 
form descriptor. (PSPERR 216) 
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MEANING 









Specified file exists, but has the 
wrong file code. 









Probably a bad environment file or 
possibly an internal software error, 
not under user control. 










Error in environment file, not 
under user control. 











Error in environment file, not 
under user control. 








Error in environment file, not 
under user control. 








Error in environment file, not 
under user control. 











Error in environment file, 
under user control. 











Error in environment file, 
under user control. 











Error in environment file, 
under user control. 











Error in environment file, not 
under user control. 











Error in environment file, 
under user control. 





ACTION 


Specify an environment file 
(code=P2680). 


Write down error message and 
contact system manager. 
Write down error message and 


contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


I 
| 


| 

















ERROR MESSAGE MEANING ACTION 
217 ~—~Bad env file: expected form Error in environment file, not Write down error message and 
number nnn, got nnn. (PSPERR 217) under user control. contact system manager. 
218 Bad env file: wrong name in compiled | Error in environment file, not Write down error message and 
form descriptor. (PSPERR 218) | under user control. | contact system manager. 
219  Badenv file: uncompiled form found | Error in environment file, not Write down error message and 
in log page desc. (PSPERR 219) under user control. contact system manager. 
| | 
220 Bad env file: invalid forms part of | Error in environment file, not | Write down error message and 
log pg desc. (PSPERR 220) under user control. | contact system manager. 
221 Bad env file: expected multi-copy Error in environment file, not | Write down error message and 
forms table. (PSPERR 221) under user control. contact system manager. 
222 Bad env file: MC form should already Error in environment file, not Write down error message and 
be compiled. (PSPERR 222) under user control. contact system manager. 
| | 
223 ~Bad env file: expected VFC | Error in environment file, not | Write down error message and 
descriptor. (PSPERR 223) under user control. contact system manager. 
| | 
224 Bad env file: expected a VFC | Error in environment file, not i Write down error message and 
file name. (PSPERR 224) under user control. contact system manager. 
| | 
| | 
225 Bad env file: VFC descriptor | Error in environment file, not | Write down error message and 
didn’t match table. (PSPERR 225) under user control. contact system manager. 
226 Bad env file: invalid VFC part of | Error in environment file, ‘not Write down error message and 
log page desc. (PSPERR 226) | under user control. contact system manager. 
227 Bad env file: VFC should already Error in environment file, not | Write down error message and 
have been compiled. (PSPERR 227) under user control. contact system manager. 
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228 Bad env file: pointer to end was nil, 


start wasn’t. (PSPERR 228) 


229 Bad env file: bad orientation in 
char descriptor. (PSPERR 229) 


230 ~—Bad env file: expected Y or N in 
PS in char desc. (PSPERR 230) 


231 Bad env file: illegal value in log 
page desc. (PSPERR 231) 


237 Bad env file: incorrect version 
number. (PSPERR 237) 


239 Bad env file: bad orientation in 
char font desc. (PSPERR 239) 


241 Bad env file: inconsistent char font 
table. (PSPERR 241) 


242 One or more character fonts do not 
match for the current device. 


249 A logical page needs char font "xxx" 
which isn’t in the file. 


250 =A logical page needs a char font, 
but there are none in the file. 
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Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Environment file converted from one 
device to another. Character reverences 
invalid for new device. 


The base character font of a 
logical page refers to a character 
font which is not defined in the 
environment. 


The base character font of a 
logical page refers to a character 
font which is not defined in the 
environment. 


ACTION 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Change the font reference(s) to file(s) 
that contain fonts for new device. 


Check logical page definitions 
or define the character font. 


Check logical page definitions 
or define the character font. 





251 


256 


257 


258 


259 


260 


261 


262 


263 


ERROR MESSAGE 


A logical page needs char font # nnn 
which isn’t in the file. 


This file can be examined, but 
not changed. 


Bad srce env file: compiled list 
was inconsistent. (PSPERR 257) 


Bad srce env file: expected a 
form table. (PSPERR 258) 


Bad dest env file: expected a 
form table. (PSPERR 259) 


Can‘t copy any more forms. 
Maximum is 32. (PSPERR 260) 


Bad srce env file: expected a 
VFC table. (PSPERR 261) 


Bad dest env file: expected 
a VFC table. (PSPERR 262) 


Can‘t copy any more VFCs. 
Maximum is 32. (PSPERR 263) 


The base character font of a 
logical page refers to a character 
font which is not defined in the 
environment. 


MPE file security violation; user does 
not have appropriate access capability 


Error in source environment file, not 
under user control. 


Error in source environment file, not 
under user control. 


Error in destination environment file, 
not under user control. 


Too many forms; each size and 


orientation of any given form 
counts as a form. 


Error in source environment file, not 
under user control. 


Error in destination environment file, 
not under user control. 


Too many VFCs. 


ACTION 


Check logical page definitions 
or define the character font. 


Contact your system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Check forms in destination file. 
Recompiling destination file 
eliminates any deleted forms. 
Then try the copy again. 


Write down error message and 
contact system manager. 


Write down error message and 
contact system manager. 


Recompile destination file to 
eliminate any deleted VFCs. 
Then try the copy again. 
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267 


269 


270 


271 


272 


273 


280 


281 
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Can't continue compiling. (No 
existing compiled font to use.) 


Can‘t continue compiling. (No 
existing compiled form to use.) 


Can't continue compiling. (No 
existing compiled VFC to use.) 


Warning: Required ComArea 
length is too big. (PSPERR 270) 
Error opening form file “xxx... 
Error accessing form “xxx... 


Out of space in env. file - copy to a 
bigger file. (PSPERR 273) 


Warning: there are no active logica! 
pages in this environment. 


Can’t use primary font, since “‘xxx "’ 
(in phys. page) is undefined). 





Could not access the specified 
character font. 


Could not access the specified 
form, 


Could not access the specified VFC. 


Cannot use the environment 
with the intrinsics. 

First line of a 2 line message. 
First line of a 2 line message. 


File reached its physical end 
of file. 


There are logical pages defined, but 
none of them are active. 


Primary font name specified in 
PHYSICAL PAGE menu is not 
defined in this environment. 








ACTION 


Identify the problem character 
font, specify a valid character 
font, then recompile. 


Identify the problem form, 
specify a valid form, then 
recompile. 


Identify the problem VFC, 
specify a valid VFC, then 
recompile. 


Reduce the size of the environment 
file. (By deleting forms, character 
fonts, etc.) 


Create a larger environment file 
using the BUILD command and 
copy existing environment into it 
using FCOPY. 


Call PACTIVATEPAGE before 
printing any.data or moving 
the pen. 


Define the character font or 
change the primary font name. 






403 


408 


409 


414 


420 


421 


428 


429 


ERROR MESSAGE 


Can‘t use primary font, since #nnn 
(in phys. page) is undefined. 


Internal error: no char. font supplied 
to delete. (PSPERR 403) 


Internal error: no log. page supplied 
to delete. (PSPERR 408) 


IDSCHAR file “xxx ” had wrong 
version #: nnn 


Bad char font file: the storage fmt 
wasn’t dot/bit. (PSPERR 414) 


Bad env file: ran out of records 
to free. (PSPERR 420) 


Bad env file: list to free was 
inconsistent. (PSPERR 421) 


Char font #/nnn in phys page 
has not been defined. Can’t 
compile. 


Font “xxx " in phys page is | 
undefined. Can’t compile. | 


*For Error Numbers 410-413 see page G-42 





Primary font number specified in 
PHYSICAL PAGE menu is not 
defined in this environment. 


Internal software error, not under 
user control. 


Internal software error, not under 
user control. 


Probably means the character font 
file has been damaged. 


Probably means the character font 
file has been damaged. 


Error in environment file, not 
under user control. 


Error in environment file, not 
under user control. 


Primary or secondary character 
font specified in the PHYSICAL 
PAGE menu is not defined in the 
environment. 


Primary or secondary character 
font specified in the PHYSICAL 
PAGE menu is not defined in 
the environment. 













ACTION 





Define the character font or change 
the primary font number. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Write down error message and 


contact system manager. 


Write down error message and 
contact system manager. 


Define the character font 
number or change the primary 
or secondary font. 


Define the character font name 
or change the primary or 
or secondary font. 
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431. 


441 


442 


448 


450 


452 


453 


455 


456 


457 
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Internal error: bad parms to 
ADD’TO’'DELETE’LIST. 
(PSPERR 431) 


Copy would result in more than 
32 character fonts — no copy done. 


Nnn char fonts to copy, but current 
env only has room for nnn more. 


Copy would result in more than 
32 logical pages — no copy done. 


Nnn logical pages to copy, but 
current env only has room for 
nan more. 


Couldn't open HP defined 
env file... xxx 


Couldn't close HP defined 
env file... xxx 


File code error while accessing 
form file. 


Internal error: Tried to add a 
duplicate key to form file. 


Internal error: #0nN occurred 
while accessing form file. 


Internal software error, not 
under user control. 


Too many character fonts in 
the environment. 


Too many character fonts in 
the environment. 


Too many logical pages in the 
environment. 


Too many logical pages in the 
environment. 


First line of a 2 line message. 


MPE file system error follows. 


First line of a 2 line message. 
MPE file system error follows. 


Form file does not have valid 
file code. 


Internal software error, not 
under user control. 


Internal software error, not 
under user control. 





ACTION 


Contact system manager. 


Recompile destination file to 
eliminate deleted fonts, if any. 


Recompile destination file to 
eliminate deleted fonts, if any. 


Recompile destination file to 
eliminate deleted logical pages, 
if any. 

Recompile destination file to 
eliminate deleted logical pages, 


if any. 


Contact system manager. 
Contact system manager. 
Specify a file with file code 
of PFORM. 


Contact system manager. 


Contact system manager. 


458 


459 


460 


461 


462 


463 


464 


465 


466 


ERROR MESSAGE 


Internal error: Tried to open new 
form file with existing name. 


Internal error: Record not found 
in form file. 


Internal error: not enough space 
form directory in form file open. 


This file is not an IDS/FORM file. 


The form file is at EOF. 


File name supplied is not an 
IDSFORM file. (Wrong file code.) 


Form file error: bad units found in 
form header. (PSPERR 464) 


Internal error: KKA count returned 
didn’t match request. 


No file name available for form “xxx ". 
























Internal software error, not 
under user control. 





internal software error, not 
under user control. 





Internal software error, not 
under user control. 





Form file is an incorrect type 
of file. 


Form file has been damaged. 





Form file specified does not 
have valid file code. 


Bad IDS/FORM file. 





Internal software error, not 
under user control. 





Form was specified, but not the 
forms file name and there was 
no default forms file name in 
PHYSICAL PAGE AND 
ENVIRONMENT DEFAULTS 
menu. 


ACTION 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Check form file name. If 


valid, contact system manager. 


Contact system manager. 


Specify a file with file code 
of PFORM. 


Contact system manager. 


Contact system manager. 


Specify the forms file name. 
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470 


478 


479 


480 


481 


482 


483 


484 
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ERROR MESSAGE 


environment. 


Too many different forms in 
env. Can't compile. (PSPERR 470) 


Can't open VEC file “xxx”. 
(FSERR nnn) 

Can't close VFC file. (FSERR nnn) 
“Xxx " not a VEC file: not ASCII. 
(PSPERR 480) 


Too many VFCs. Can't compile. 
(PSPERR 4871) 


Bad ““VFC” line in file “xxx “. 
(PSPERR 482) 


Can’t read from VEC file “’xxx”. 


(FSERR nnn) 


“Xxx " not a VEC file: bad 1st line. 
(PSPERR 484) 





There is no default form file for this 












Form was specified, but not the 
forms file name and there was 
no default forms file name in 
PHYSICAL PAGE AND 
ENVIRONMENT DEFAULTS 
menu. 


More than 32 forms; each size and 
orientation of any given form counts 


as a form. 


File system error occurred. 


File system error occurred. 


File specified as the VFC file is a 


binary file; VFC file must be ASCII. 


More than 32 VFCs, not under 
user control. 


Record beginning with “VFC” 
is in error. 


FWRITEDIR failed. 








First record was not in VFC 
file format. 





















ACTION 





Specify the forms file name. 


Delete forms until there are 
only 32 forms. 


Refer to the file system error 
number for more information. 


Refer to the file system error 


number for more information. 


Specify a valid VFC file. 


Contact system manager. 


Check VFC files for valid format. 


Refer to the file system error 
number for more information. 


Check VFC file for valid format. 





485 


486 


490 


491 


492 


493 


494 


495 


496 


ERROR MESSAGE 


No “VFC" line in file “xxx ". 
(PSPERR 485) 


This is not an IDSCHAR cell file. 


Can‘t open IDSCHAR file “xxx ". 
(FSERR !) 


File “xxx '’ is not an IDSCHAR file. 


Can't read from file “xxx "’. 


Can't find right size in “xxx ". 
(PSPERR 493) 


Can't read cell versions from file 


4d Lad 


XXX 


Bad IDSCHAR file — ran out of 
dot/bit. (PSPERR 495) 


Can't close “xxx "’. (FSERR !) 


Missing record beginning with 
“VEC” in the file specified 
for VFC. 
















Cell file specified has invalid file 
code, should be PCHAR. 


FWRITEDIR failed. 





Cell file specified has invalid file 
code, should be PCHAR. 


Second line of a 2 line message. 
First tine displayed file system 
error. 










Character font file has been 
changed since you defined it, 
actual size is not in the file. 


Second line of a 2 line message. 
First line displayed file system 
error. 





Probably means the character font 
file has been damaged. 


FWRITEDIR failed. 


ACTION 


Check VEC file for valid format. 


Verify the name of the cell file 
specified. 


Refer to the file system error 
number for more information. 
Verify the name of the cell file 
specified. 

Refer to the file system error 


number for more information. 


Use CHARACTER FONT menu 
to define an actual size which 
exists in the file. 


Refer to the file system error 
number for more information. 


Contact system manager. 


Refer to the file system error 
number for more information. 
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801 Internal error: bad parameters to 
COMPILE’FORM. (PSPERR 801) 


802 Bad form file: form head missing 
for form “nnn '’. (PSPERR 802) 


803 Bad form file: form head bad in 
form “nnn, (PSPERR 803) 


804 Warning: scan line nnn. Too many 
triplets. (PSPERR 804) 


806 Can‘t do FPOINT on triplet 
temp file. (FSERR nnn) 
(PSPERR 806) 


807 Can‘t sort the triplet file. 
SORTINITIAL failed. 
(PSPERR 807) 


808 Can't sort the triplet file. 
SORTOUTPUT failed. 
(PSPERR 808) 


810 Can't write to dot/bit temp file. 
(FSERR !) (PSPERR 810) 


811 Can't read from dot/bit 
temp file. (FSERR !) 
(PSPERR 811) 
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Internal software error, not 
under user control. 







System is unable to process 
form file. Form file has been 
damaged and must be restored. 








System is unable to process 
form file. Form file has been 
damaged and must be restored. 








Form is too complicated; too many 
graphics (line, box, shading, etc.) and 
characters or logos on a given line. 







FWRITEDIR failed. 






Error in SORT/3000 processing. 


Error in SORT/3000 processing. 






FWRITEDIR failed. 







FWRITEDIR failed. 


ACTION 


Contact system manager. 


Contact system manager to 
restore file. 


Contact system manager to 
restore file. 


Simplify the form. 


Refer to the file system error 
number for more information 


Contact system manager. 


Contact system manager. 


Refer to the file system error 
number for more information 


Refer to the file system error 
number for more information 


812 


813 


815 


816 


817 


818 


819 


820 


821 


ERROR MESSAGE 


Bad form file: found a 
diagonal line. (PSPERR 812) 


Warning: the form had to be 
clipped. 
Bad form file: found a duplicate 


form head. (PSPERR 815) 


Bad form file: found illegal element 
type: nnn. (PSPERR 816) 


Bad form file: bad element length. 
(PSPERR 817) 


Internal error: can’t find form “xxx”. 


(PSPERR 818) 
Bad form file: hit EOR before EOR 
element found. (PSPERR 819) 


Can't open the triplet temp file. 
(FSERR nnn) (PSPERR 820) 


Can‘t open the dot/bit temp file. 
(FSERR nnn) (PSPERR 821) 


System is unable to process 
form file. Form file has been 
damaged and must be restored. 


Text or logo extends beyond the 


form boundaries. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


Internal software error, not 
under user control. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


FWRITEDIR failed. 


FWRITEDIR failed. 


ACTION 


Contact system manager to 
restore file. 


Check placement of text or logo. 


Contact system manager to 
restore file. 


Contact system manager to 
restore file. 


Contact system manager to 
restore file. 


Contact system manager. 


Contact system manager to 
restore file. 


Refer to the file system error 
number for more information. 


Refer to the file system error 
number for more information. 
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822 Bad form file: bad thickness value 
in line element. (PSPERR 822) 

823 Bad form file: can’t find subform. 
(PSPERR 823) 

824 internal error: can't switch to 
subform. (PSPERR 824) 

825 Internal error: can’t switch back 
from subform. (PSPERR 825) 

826 Bad form file: a subform contained 
another subform. (PSPERR 826) 

827 Bad form file: bad line type nnn 
in line element. (PSPERR 827) 

828 Can't write to triplets temp file. 
(FSERR nnn) (PSPERR 828) 

829 Bad form file: bad shading percentage nnn. 
(PSPERR 829) 
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ERROR MESSAGE 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


System is unable to process 
form file. Form file has been 
damaged and must be restored. 


Internal software error, not 
under user control. 


Internal software error, not 
under user control. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


FWRITEDIR failed. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


ACTION 


Contact system manager to 
restore file. 


Contact system manager to 
restore file. 


Contact system manager. 


Contact system manager. 


Contact system manager to 
restore file. 


Contact system manager to 
restore file. 


Refer to the file system error 
number for more information. 


Contact system manager to 
restore file. 


830 


831 


852 


853 


854 


855 


856 


857 


859 


ERROR MESSAGE 


Bad form file: corners of a box 
were out of order. (PSPERR 830) 


Warning: missing character(s) or logo(s). 


Black rectangle used. 


Bad form file: bad character orientation. 


(PSPERR 852) 


Bad form file: bad text direction. 
(PSPERR 853) 


Couldn't close cell file ‘xxx ". 
(PSPERR 854) 


Couldn’t open cell file “‘xxx ". 
(PSPERR 855) 


Warning: Expected logo file ‘‘xxx ” 
not font. 


Warning: Expected font file “xxx ” 
not logo. 


Error storing dot/bit. (PSPERR 859) 


System is unable to process 
form file. Form file has been 
damaged and must be restored. 


In a field heading or logo, tried to 
print a character that is not defined 
in the cell file. 


System is unable to process 
form file. Form file has been 
damaged and must be restored. 


System is unable to process 
form file. Form file has been 


damaged and must be restored. 


Second line of a 2 line message, 


first line displayed file system error. 


Second line of a 2 line message, 


first line displayed file system error. 


Specified a logo file in the FIELD 
FONT menu but file is a character 
font file. Form may not print as 
expected. 


Did not specify a logo file in the 
FIELD FONT menu but file is a 
logo file. Form may not print as 
expected. 


Second line of a 2 line message, 


first line displayed file system error. 


ACTION 


Contact system manager to 
restore file. 


Check the field heading text 
or the character font or logo 
file. 


Contact system manager to 
restore file. 


Contact system manager to 
restore file. 


Refer to MPE file system error. 


Refer to MPE file system error. 


Change the specification or the 
file name. 


Change the specification or 
the file name. 


Refer to MPE file system error. 
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860 No font sizes in cell file “xxx ", 
(PSPERR 860) 

861 Form file containing form “xxx " is 
bad. (PSPERR 861) 

862 Error getting XDS. GETDSEG returned 
nnn. (PSPERR 862) 

863 Error altering size of XDS, possible 
internal error. (PSPERR 863) 

864 Error moving character description 
from XDS. (PSPERR 864) 

865 Error expanding XDS. (PSPERR 865) 

866 = Error moving character description 
to XDS. (PSPERR 866) 

867 Form file containing form “xxx " 
is bad. (PSPERR 867) 

868 __ Bad cell file ‘xxx ’’: bad units. 
(PSPERR 868) 

869 Couldn’t free the extra data segment. 
(PSPERR 869) 
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Cell file is empty. 








System is unable to process 
form file. Form file has been 
damaged and must be restored. 









GETDSEG failed. 





Internal software error, not 
under user control. 








Internal software error, not 
under user control. 











Internal software error, not 
under user control. 











Internal software error, not 
under user control. 







System is unable to process 
form file. Form file has been 
damaged and must be restored. 









Cell file has probably been 
damaged. 










Internal software error, not 
under user control. 





ACTION 
Check the specified cell file. 


Contact system manager to 
restore file. 


Refer to the error number. 


Contact system manager. 


Contact system manager. 
Contact system manager. 
Contact system manager. 


Contact system manager to 
restore file. 


Contact system manager. 


Contact system manager. 


870 


871 


872 


873 


874 


875 


900 


901 


902 


903 


ERROR MESSAGE 


Configured extra data seg size too small. 


Need (PSPERR 870) 


Bad baseline in cell file. “xxx “. 
(PSPERR 871) 


Warning: a field has an unspecified 
character font. 


ALTDSEG error while checking what 
size dseg we got. (PSPERR 873) 


Bad cell file: max P.S. bound less 
than min. (PSPERR 874) 


Error accessing cell file “xxx "’. 
(PSPERR 875) 


Couldn‘t close the environment file. 
(FSERR nnn) 


Not enough room in the PSP Com Area. 


Need nnn words. 
Couldn’t open the environment file. 


(FSERR nnn) 


File wasn’t an environment file. 
Wrong file code. 


internal software error, not 
under user control. 


Cell file has probably been 
damaged. 


Cell file name was not specified 
in the FIELD FONT menu. 


Internal software error, not 
under user control. 


Cell file has probably been 
damaged. 


Second line of a 2 line message, 


first line displayed file system error. 


FWRITEDIR failed. 


User program specified insufficient 
space. 


FWRITEDIR failed. 


Environment file associated with 
output print file is in error. 





ACTION 


Contact system manager. 


Contact system manager. 


Check the cell file name. 


Contact system manager. 


Contact system manager. 


Refer to MPE file system error. 


Refer to the file system error 
number for more information 
and possible action. 


Check the ComArea length 
parameter in PINITIALIZE and 
PINITDEVICE. 

Refer to the file system error 
number for more information 
and possible action. 


Check the FILE command to 
determine problem file. 
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ERROR MESSAGE 





904 File wasn’t an environment file. 
Wrong record size. 

905 Couldn't read the environment file’s 
header. (FSERR nnn) 

908 Bad environment file. 

909 FGETINFO failed on the 
environment file. (FSERR nnn) 

910 Bad env file: file header had 
wrong type. 

911 Bad env file: illegal pointer in 
file header. 

912 Couldn't read the char font table. 
(FSERR nnn) 

913 Couldn’t read a char font 
descriptor. (FSERR nnn) 

914 Bad env file: char font table 
had wrong type. 

915 Bad env file: a char font descriptor 
had wrong type. 
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Environment file associated with 
output print file is in error. 








FWRITEDIR failed. 





Environment file has been 
damaged. 








FWRITEDIR failed. 





Environment file has been 
damaged. 









Environment file has been 
damaged. 







FWRITEDIR failed. 







FWRITEDIR failed. 





Environment file has been 
damaged. 










Environment file has been 
damaged. 






ACTION 


Check the FILE command to 
determine problem file. 


Refer to the file system error 
number for more information 
and possible action. 

Contact system manager. 
Refer to the file system error 
number for more information 


and possible action. 


Contact system manager. 


Contact system manager. 


Refer to the file system error 
number for more information. 


Refer to the file system error 
number for more information. 


Contact system manager. 


Contact system manager. 


917 


918 


919 


920 


921 


922 


923 


924 


925 





ERROR MESSAGE 


Couldn't read the logical page table. 
(FSERR nnn) 


Bad env file: the logical page table 
had the wrong type. 
Couldn’t read a logical page 


descriptor. (FSERR nnn) 


Bad env file: a logical page 
descriptor had the wrong type. 


Couldn’‘t read compiled log page rec. 


(FSERR nnn) 

Bad env file: compiled log page rec 
had wrong type. 

Couldn't read the physical page 
descriptor. (FSERR nnn) 

Bad env file: the physical page 
descriptor had the wrong type. 
Couldn't read the compiled 


physical page. (FSERR nnn) 


Bad env file: the compiled physical 
page had the wrong type. 





MEANING 


FWRITEDIR failed. 


Environment file has been 
damaged. 


FWRITEDIR failed. 


Environment file has been 
damaged. 


FWRITEDIR failed. 


Environment file has been 


FWRITEDIR failed. 


Environment file has been 
damaged. 


FWRITEDIR failed. 


| 


Environment file has been 
damaged. 




















ACTION 








Refer to the file system error 
number for more information 


Contact system manager. 


Refer to the file system error 
number for more information 


Contact system manager. 


Refer to the file system error 
number for more information 


Contact system manager. 


Refer to the file system error 
number for more information 


Contact system manager. 


Refer to the file system error 
number for more information 


Contact system manager. 
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ERROR MESSAGE 
926 _ Bad env file: bad pointer in 
phys page desc. 


927 Bad env file: nil pointer to 
compiled phys page in PP desc. 


928 Couldn't read the multi-copy forms 
descriptor. (FSERR nnn) 


929 Bad env files: MC forms descriptor 
had wrong type. 

930 Couldn't read a single-copy forms 
descriptor. (FSERR nnn) 

931 Bad env file: Single copy forms 


descriptor had wrong type. 


932 Ran out of space while building the 
PSP Com Area. 


933 Couldn’t read the form table. 
(FSERR nnn) 


934 Bad env file: the form table had 
the wrong type. 


Jan 84 
G~-22 


MEANING 










Environment file has been 
damaged. 










Environment file has been 
damaged. 









FWRITEDIR failed. 





Environment file has been 
damaged. 






FWRITEDIR failed. 










Environment file has been 
damaged. 









Internal software error, not 
under user control. 








FWRITEDIR failed. 





Environment file has been 
damaged. 





ACTION 


Contact system manager. 


Contact systems manager 


Refer to the file system error 
number for more information. 


Contact system manager. 


Refer to the file system error 
number for more information. 


Contact system manager. 


Contact system manager. 


Refer to the file system error 
number for more information. 


Contact system manager. 


935 


936 


937 


938 


939 


940 


941 


942 


943 


944 


ERROR MESSAGE 


Couldn't read a compiled form 
descriptor. (FSERR nnn) 


Bad env file: a compiled form 
descriptor had the wrong type. 


Bad env file: bad symbol table. 


Can't read symbol table record. 


(FSERR nnn) 
Bad env file: a symbol table 
record had the wrong type. 


Logical page orientation in 
ComArea was bad. 


No current form — can’t write 
to fields. 


The current logical page has no 
entry in the PSPComArea. 


The logical page entry for the 
current LP is bad. 


Can‘t move the pen. 


(FDEVICECONTROL error nnn) 


FWRITEDIR failed. 


Environment file has been 
damaged. 


Environment file has been 
damaged. 


FWRITEDIR failed. 


Environment file has been 
damaged. 


ComArea has been damaged. 


Called PWRITEFIELD ona 


logical page that has no form. 


ComArea has been damaged. 


ComArea has been damaged. 


FDEVICECONTROL failed. 


ACTION 


Refer to the file system error 
number for more information. 


Contact system manager 


Contact system manager. 


Refer to the file system error 
number for more information. 


Contact system manager. 
Check your program. 
Check your program. 
Check your program. 
Check your program. 


Refer to FDEVICECONT ROL 
error number. 
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G-24 





ERROR MESSAGE 





Can't write to field. (FSERR nnn) 


946 Form “xxx " is not on the 
current logical page. 

947 Form “xxx "isn’t on the 
current log. page or the 
multi-copy table. 

948 Bad character font entry. 

949 Couldn't find field ‘xxx “. 

950 ~=—‘ There are no active logical pages. 

951 Can't go to the next page. 
(FSERR nnn) 

952 ~=Nnn is an illegal logical page number. 
Should be 0 to 31 or -1. 

Jan 84 





MEANING 





FWRITEDIR failed. 


PNEWFORM was called using 

a form that is not on the logical 
page. (The current logical page is 
not the MULTICOPY FORMS 
logical page.) 


PNEWFORM was called using a 
form that is neither on the logical 
page nor in the MULTICOPY 
FORMS TABLE. 


ComArea has been damaged. 


Calied PWRITEFIELD using a 

field which is not in the current 
Subform. If no current subform, 
then field is not in any subform. 


All pages have been deactivated or 
no initially active pages were defined 
in the environment. 


FWRITEDIR failed. 


An intrinsic was called using an 
invalid logical page number. 










rr er er re eer ene 


ACTION 





Refer to the file system error 
number for more information. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Activate a logical page. 


Refer to the file system error 
number for more information. 


Check your program. 


953 


954 


955 


956 


957 


958 


959 


960 


961 


—_— i H 


ERROR MESSAGE 


Can't activate logical page. 
(FDEVICECONTROL error nnn) 


Can't deactivate logical page. 
(FDEVICECONTROL error nnn) 


Can’t select character fonts. 
(FDEVICECONTROL error nnn) 


A font number of nnn is illegal. 
Must be 0-31 or -1. 


The specified primary font (nnn) 
is not in the environment. 


The specified secondary font (nnn) 
is not in the environment. 


Warning: line too long — truncated. 


Nnn isn't a legal subfield number. 
Should be greater than 0, or -1. 


Subform “xxx ” is not in the 
current form. 


MEANING 


FDEVICECONTROL failed. 


FDEVICECONTROL failed. 


FDEVICECONTROL failed. 


An intrinsic was called using an 
invalid character font number. 


An intrinsic was called using a 
primary font number which is 
not defined. 


An intrinsic was called using a 
secondary character number font 
which is not defined. 


A given line of data exceeded 
PWRITEFIELD’s buffer size 
(250 characters). 


An intrinsic was called using an 
invalid subfield number. 


PNEWSUBFORM was called using a 
subform name that is not defined in 
the current form. 





ACTION 


Refer to FPDEVICECONTROL 


error number. 


Refer to FDEVICECONTROL 


error number. 


Refer to FDEVICECONT ROL 


error number. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 
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962 


963 


964 


965 


966 


967 


968 


969 


970 


971 


ERROR MESSAGE 


The string is too long — its length 
would be > 32767 dots. 


Bad current character font 
number in the ComArea. 


Character font number nnn is 
not in the environment. 


Character font “xxx " is not 
in the environment. 


The primary character font 
number is not in the 
environment. 


The secondary character 
font number is not in the 


environment. 


Bad current logical page 
number in the ComArea. 


Logical page number nnn is not 
in the environment. 


Invalid language parameter 


Nnn isn’t a legal subfield for 
this field. Should be 1 or -1. 
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PST RINGWIDTH intrinsic was called 
using too large a value in the string 
length parameter. 








ComArea has been damaged. 






An intrinsic was called using an 
undefined character font number. 










An intrinsic was called using an 
undefined character font. 







An intrinsic was called using a 
primary font number which is 
not defined. 








An intrinsic was called using a 
secondary character font number 
which is not defined. 







ComArea has been damaged. 











An intrinsic was called using an 
undefined logical page number. 







PINITIALIZE or PINITDEVICE was 
called with an invalid value in the 
language parameter. 







PWRITEFIELD was called using 
an invalid subfield number. 






ACTION 


Check your program 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


972 


973 


974 


975 


976 


977 


978 


979 


980 


ERROR MESSAGE 


Can't get environment file name 
(FSERR nnn) 


The file supplied apparently 
had no environment file. 


PERRMSG was called when 
error had occurred. 


PNEWFORM was called with 
a blank form name. 


Bad form name “xxx ". 
(Must begin with a letter, or be 
qe or “ory 


A -1 was used as the subfield 
number in a field with nnn 
subfields. 


Can't go to the next physical 
page. (FSERR nnn) 


Nnn isn’t a legal subfield 
for this field. Should be 1 to 
nnn, or -1. 


Warning: logical page 2NN was 
already active. 


FWRITEDIR failed. 


FFILEINFO indicated there was 
no environment file associated 
with output print file. 


PNEWFORM was called using an 
invalid form name. 


Value of -1 for subfield number is 


valid only when there is one subfield. 


FWRITEDIR failed. 


PWRITEFIELD was called using an 
invalid number in the subfield 
parameter. 


PACTIVATEPAGE was called using 
the page number of an active page. 





ACTION 


Refer to the file system error 
number for more information 
and possible action. 


Check file equation or 
FOPEN. 
Check your program. 


Check your program. 


Check your program. 


Check your program. 


Refer to the file system error 


number for more information. 


Check your program. 


Check your program. 
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ERROR MESSAGE 










Warning: logical page nnn was 
already inactive. 





982 Warning: there are no initially 
active pages in the environment. 


983 There is no currently active 
jogical page to go to. 


984 ‘There is no current logical page. 


985 _-1 was used for a logical page #, 
but there is no current page. 


986  Deactivating the defauit 
logical page is not allowed. 


987 Warning: all logicai pages 
have been deactivated. 


begin building the PSP 


j 
| 
| 
j 
988 Not enough space to even 
ComArea. 
i 
i 
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PDEACTIVATEPAGE was called 
using the page number of an 
inactive page. 


No logical pages were defined as 
initially active. 


PNEWPAGE or PNEWPHYSPAGE 


was called when there were no 
active logical pages. 


No logical pages were defined as 
initially active in the environment. 


The value -1 used in the logical page 
number parameter in PLOGPAGEINFO 
means to use the current page, but 


there is none. 


PDEACTIVATEPAGE was called 
using the default page number. 


There must always be one active 


logical page. Activate a logical page 
before moving off the last deactivated 


logical page. 


Need at least 158 words in the 
ComArea to determine the actual 
space needed for ComArea. User 


program specified insufficient space. 


ACTION 


Check your program. 


Activate a logical page. 


Activate a logical page. 


Activate a logical page. 


Check your program. 


Check your program. 
Check your program. 
Check the ComArea length 


parameter in PINITIALIZE or 
PINITDEVICE. 






989 


990 


991 


992 


993 


994 


ERROR MESSAGE 


Not enough space to even 
begin building the PSP 
ComArea. 


Not enough space to even 
begin building the PSP 
ComArea. 


Not enough space to even 
begin building the PSP 
ComArea. 


litegal character font name “xxx ”. 
(Must begin with a letter) 


Bad ComArea — probably hasn’t been 
initialized yet. 


(Nan, nnn) is illegal. Can’t have 
negative absolute coordinates. 













Need at least 158 words in the 
ComArea to determine the actual 
space needed for ComArea. User 
program specified insufficient space. 









Need at least 158 words in the 
ComArea to determine the actual 
space needed for ComArea. User 
program specified insufficient space. 











Need at least 158 words in the 
ComArea to determine the actual 
space needed for ComArea. User 
program specified insufficient space. 


PFONTNUM was called using an 
invalid character font name. 








PINITIALIZE or PINITDEVICE 
must be called once before calling 
any other intrinsic. 





PMOVEPENABS was called using 
a negative number in either the 

x or y coordinate parameters 

or both. 


ACTION 


Check the ComArea length 
parameter in PINITIALIZE or 
PINITDEVICE. 


Check the ComArea length 
parameter in PINITIALIZE or 
PINITDEVICE. 


Check the ComArea length 
parameter in PINITIALIZE or 
PINITDEVICE. 


Check your program. 


Check your program. 


Check your program. 
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995 X coordinate nnn is too big. 
Logical page width is nnn. 
996 Y coordinate nnn is too big. 
Logical page height is nnn. 
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ERROR MESSAGE 


ACTION 


PMOV EPENABS or PMOVEPENREL Check your program. 
was called using a value in the 

x-coordinate parameter which exceeds 

the logical page width. 


PMOVEPENABS or PMOVEPENREL Check your program. 
was called using a value in the 

y -coordinate parameter which exceeds 

the logical page height. 


997 


998 


1000 


1001 


1002 


1003 


1004 


1005 


1006 


1007 


ERROR MESSAGE 


This intrinsic is not applicable to the 
initialized device xxx. 


This intrinsic is not useable without an 
opened spoolfile. 


Image number nn is out of range; must 
be between 0 and 371 inclusive. 


Can't open raster file xxx (FSERR nnn). 


FGETINEO failed; can’t read the file 
label (FSERR nnn). 


The file is not a raster file; invalid file 
code nnn. 


The file is not a raster file; invalid 
record size. 


No raster file name was specified. 


Can't close raster file xxx (FSERR nnn). 


An error occurred while reading the file 
header (FSERR nnn). 


MEANING 


The intrinsic being called cannot be 
used with the output device 
specified. 


Only the PCONVERTFIGURE and 
PFIGUREINEFO intrinsics can be 
used without an open spoolfile. 


The raster image number must be 
between 0 and 31 inclusive. 


Unable to access specified file. 
Internal software error; not under 
user control. 


The specified file has a code that is 
not a raster file code. 


The specified file has the wrong 
record size to be a raster file. 


The raster file name parameter is all 
blanks. 


File System error occurred in 
attempt to close raster file. 


Internal software error; not under 
user control. 





ACTION 


Check your program. 


Check your program. Spoolfile should 
not be set to -1 in a call to 
PINITDEVICE. 

Check your program. 

Refer to the file system error number 


for more information. 


Note the file system error number and 
contact system manager. 


Check your file. The raster file code Is 
1114 or RASTR. 


Check your file. Raster file record 
size is 512 words. 


Check your program. 
Refer to the file system error number 
for more information. 


Note file system error number and 
contact system manager. 
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1008 


1009 


1010 


1011 


1012 


1013 


1014 


1015 


1016 


1017 
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ERROR MESSAGE 


Reached EOF while trying to read the 
file header (FSERR nnn). 


DMOVIN failed; bounds violation error. 


DMOVOUT failed; bounds violation 
error. 


XDS access failed; invalid Figure Load 
Table index. 


The raster file was converted for a 
device other than that initialized. 
The partitioned raster file contains no 


raster data. 


An error occurred while trying to read 
the raster file (FSERR nnn). 


Encountered FDEVICECONTROL 


error nnn while trying to load image nn. 


XXX is not a device supported by 
IFS/3000. 


The header record count does not 
match the number found. 


Error in raster file; probably bad 
number of file header records. 











Internal software error; not under 
user control. 








Internal software error; not under 
user control. 












Internal software error; not under 
user control. 










Output device specified for 
initialization must be the same as 
that specified for conversion. 







Error in raster file. 











internal software error; not under 
user control. 








Internal software error; not under 
user control. 










The specified output device cannot 
be used with the IFS/3000 intrinsics. 






Error in raster file. 





ACTION 


Recreate the raster file. 

Contact system manager. 
Contact system manager. 
Contact system manager. 


Check your program. 


Create a raster file that contains dat 
Note file system error number and 
contact system manager. 

Contact system manager. 

Check your program or contact 
system manager. 


Recreate the raster file or create a 
new raster file. 


1018 


1019 


1020 


1021 


1022 


1023 


1024 


1025 


1026 


1027 


1028 


ERROR MESSAGE 


Internal problem; downloaded image 
count nnn is invalid. 


Warning: New image replaces previously 
loaded image nn. 


Encountered FDEVICECONTROL 


error nn while trying to delete image nn. 
Image nn has not been loaded. 

Bad data word count nn found in raster 
file. 


invalid units parameter n; must be O, 1, 
2 or 3. 


invalid position mode parameter n; must 
be O or 1. 


Encountered FDEVICECONTROL 
error nn while trying to print image nn. 


Relative position (n, n in dots) would 
be off the logical page. 


Absolute position (n, n in dots) would 
be off the logical page. 


X-position does not reduce to a value in 
the range -32768 . . 32767. 


MEANING 


Internal software error or corrupted 
COMAREA. 


Image nn replaces the image 
previously assigned number nn. 


Internal software error; not under 
user control. 


An image cannot be printed or 
deleted before it has been loaded. 


Error in raster file. 
Units must be 0 for dots, 1 for inches, 
2 for cm., or 3 for mm. 


Position mode must be 0 for relative 
or 1 for absolute positioning. 


Internal software error; not under 
user control. 


X or Y position is too large or 
negative and too large. 


X or Y position is too large. 


X position is too large or too small. 


ACTION 


Check your COMAREA or contact 


system manager. 


None — warning only. 


Contact system manager. 


Check your program. 


Recreate the raster file. 


Check your program. 


Check your program. 


Contact system manager. 


Check your program and logical page 


dimensions. 


Check your program and logical page 
dimensions. 


Check your program. 
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ERROR MESSAGE 


1029 Y-position does not reduce to a value in 
the range -32768 . . 32767. 


1030 Can't specify a negative absolute X- 
position (nnn in dots). 


1031 Can't specify a negative absolute Y- 
position (nnn in dots). 


1032 Invalid device xxx for figure file 
conversion. 


1033 Invalid raster image rotation n; must be 
0, 90, 180 or 270. 


1034 AGLERR — the device xxx is not 
supported, 


1035 . Not enough space to create 
AGLComArea; requested nnn. 


1039 Can't open temporary file xxx 
(FSERR nnn). 


1040 Can't rename temporary file xxx 
(FSERR nnn). 


1041 Can't close temporary file xxx 
(FSERR nnn). 


1042 Can’t FCLOSE renamed temporary file; 
failed on re-rename (FSERR nnn). 
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Y position is too large or too small. 











Only positive values are allowed with 
absolute positioning. 










Only positive values can be used with 
absolute positioning. 






Output device specified cannot accept 
a figure file for conversion. 










Only 0, 90, 180 and 270 are valid 
raster image rotations. 










Internal problem; not under user 
control. 











Internal software error; not under 
user control. 








Specified file has not been opened. 


Specified file has not been renamed. 







Specified file has not been closed. 








File has not been renamed; attempt 
to rename back to original name also 
failed. 







ACTION 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Contact system manager. 


Contact system manager. 


Refer to the file system error number 


for more information. 


Refer to the file system error number 
for more information. 


Refer to the file system error number 
for more information. 


Refer to the file system error number 
for more information. 


1043 


1044 


1045 


1046 


1047 


1048 


1049 


1050 


1051 


1052 


1053 


ERROR MESSAGE 


Can't FCLOSE renamed temporary file 
(FSERR nnn). 


Internal problem; no Device Driver 
matches xxx in case selection. 


Internal problem; no Units matches xxx 
in case selection. 


Encountered FDEVICECONTROL 
error nnn while printing temporary 
image. 


Image height (nnn in MM) is larger than 
the device will allow. 


Image height (nnn in MM) cannot be 0 
or negative. 


The file header crash word is set to true. 


Image width (nnn in MM) larger than the 
device will allow. 


Figure height read from figure file is 0; 
no image to convert. 


Figure height read from figure file is 
<0; no image to convert. 


Figure width read from figure file is 
<0; no image to convert. 


File has been renamed, but attempt 


to close failed. 


Internal software error; not under 
user control. 


Internal software error; not under 
user control. 


Internal software error; not under 
user control. 
Image has not been printed. 


Image has not been printed. 


Error in raster file. 


Image height is too large, resulting 
in width also being too large. 


Error in figure file. 


Error in figure file. 


Error in figure file. 





ACTION 


Refer to the file system error number 
for more information. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Change image height parameter to a 
smaller value. 


Change image height parameter to a 
larger positive value. 


Recreate raster file. 

Change image height parameter to a 
smaller value. 

Recreate figure file. 


Recreate figure file. 


Recreate figure file. 
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ERROR MESSAGE 


1054 ~=‘Invalid raster image type n; must be 0 or 
1, 

1055 Bad Image Height; can‘t reduce to a 
value in the range -32768 . . 32767. 

1056 Internal error; PFIGUREINFO item nn 
not applicable to raster file. 

1057. GETDSEG error. Returned index of 
n; invalid length. 

1058 GETDSEG error. Returned index of 
n; too many XD&s this process. 

1059 GETDSEG error. Returned index of 
nnn; not enough storage for XDS. 

1060 GETDSEG error. Returned index of 
nnn; stack frozen — can’t expand. 

1061 GETDSEG error. GETDSEG returned 
index of nnn. 

1062 Can't rename temporary file to xxx 
(FSERR nnn). 

1063 xxx already exists as a permanent file. 

1064 xxx already exists as a temporary file. 

Jan 8&4 


G-36 


Raster image type must be 0 for 
temporary or 1 for permanent. 







Image height is too large. 











Internal software error; not under 
user control. 











Internal software error; not under 
user control. 








Internal software error; not under 
user control. 











Internal software error; not under 
user control. 








Internal software error; not under 
user control, 












Internal software error; not under 
user control. 








Specified file has not been renamed. 


Specified file has already been created. 






Specified file has already been created. 





ACTION 


Check your program. 


Check your program. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Refer to the file system error number 


for more information. 


Purge file or use another file name. 


Purge temporary file, save and rename 
to permanent file, or use another file 
name. 


1065 


1066 


1067 


1068 


1069 


1070 


1071 


1072 


1073 


1074 





ERROR MESSAGE 


Invalid file type n; must be -1, 0 or 1. 
Figure width read from figure file is 0; 
no image to convert. 


Real number in xxx too small to 
represent. 


Invalid char and real number too small 
to represent In xxx. 

Real number in xxx too large to 
represent. 

Invalid char and real number too large 
to represent in Xxx. 

invalid character in xxx to convert to 


a real number. 


No number found in xxx to convert to 
a real number. 


Error while attempting to convert xxx 
to a real number. 


Cannot convert real number to a string; 
result returned is xxx. 


File type must be -1 for unknown, 0 
for raster, 1 for figure. 


Error in figure file. 





ASCII string contains real number 
that is too small. 


ASCII string contains. invalid 
character and real number that is 
too small. 


ASCII string contains real number 
that is too large. 


ASCII string contains invalid | 
character and real number that is 
too large. 


ASCII string contains invalid 
character. 














ASCII string must contain a real 
number. 


Internal software error; not under 
user control. 


Real number to be converted is 
probably too large. 











ACTION 














Check your program. 


Recreate figure file. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Check your program. 


Contact system manager. . 


Check your program. 
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1100 AGLERR 501. XMin >=XMax or 
YMin >=YMax. 


1101 AGLERR 508. One or more viewport 
corners outside the NDC space. 


1102 AGLERR 510. NDC position is 
outside the current viewport. 


1103 AGLERR 512. WC position is outside 
the current viewport. 


1104 AGLERR 705. The view surface is 
already initialized. 


1105 AGLERR 706. No output device is 
associated with the view surface. 


1106 AGLERR 708. The specified surface 
has not been initialized. 


1107 AGLERR 717. The graphics package 
has not been initialized. 


1108 AGLERR 718. The function is not 
supported by the device. 


1109 AGLERR 1001. The GSET array is 
not large enough. 


1110 AGLERR 1004. The string length is 
<0. 
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Internal software error: not under 
user control. 











Internal software error; not under 
user control. : 











Internal software error; not under 
user control. 











Internal software error: not under 
user control. 











Internal software error; not under 
user control. 











Internal software error: not under 
user control. 











Internal software error; not under 
user control. 











Internal software error: not under 
user control. 











Internal software error; not under 
user control. 











Internal software error; not under 
user control. 











Internal software error; not under 
user control. 






ACTION 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Contact system manager. 


1111 


1112 


1113 


1114 


1115 


1116 


1117 


1118 


1119 


1120 


ERROR MESSAGE 


AGLERR 1101. Mapping value is not 0 
or 1. Map remains unchanged. 


AGLERR 1201. FOPEN failure 
(FSERR nnn). 


AGLERR 1202. FCLOSE failure 
(FSERR nnn). 


AGLERR 1203. Error writing to device 
(FSERR nnn). 


AGLERR 1204. Error reading from 
device (FSERR nnn). 


AGLERR 1210. Error occurred when 
calling FCHECK. 


AGLERR 1215. FFILEINFO failure 
(FSERR nnn). 
AGLERR 1216. DMOVOUT failure. 


AGLERR 1217. DMOVIN failure. 


AGLERR 1218. GETDSEG failure. 


Internal software error; not under 
user control. 

















Internal software error; not under 
user control. 





Internal software error; not under 
user control. 





Internal software error; not:under 
user control, 





Internal software error; not under 
user control. 





Internal software error; not under 
user control. 





Internal software error; not under 
user control. 





Internal software error; not under 
user control. 





Internal software error; not under 
user control, 





Internal software error; not under 
user control. 


ACTION 


Contact system manager. 
Note file system error number and 
contact system manager. 


Note file system error number and 
contact system manager. 


Note file system error number and 
contact system manager. 


Note file system error number and 
contact system manager. 


Contact system manager. 
Note file system error number and 
contact system manager. 
Contact system manager. 


Contact system manager. 


Contact system manager. 
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1121 
1122 
1123 
1124 
1128 
1126 
1127 
1128 
1129 
1130 


1131 
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AGLERR 1219. FREEDSEG failure. 


AGL error 1301. Internal error. A call 
to BINARY failed. 


AGLERR 1302. Internal error. 
Floating point result out of range. 


AGLERR 1502. No figure of that name 
was found. 


AGLERR 1504. Specified figure file is 
currently in use. 


AGLERR 1505. No figure file of that 
name can be found. 


AGLERR 1506. Rotation angle out of 
range. 


AGLERR 1507. Scale factor out of 
range. 


AGLERR 1509. Attempt to open a 
figure file failed (FSERR nnn). 


AGLERR 1510. Attempt to close a 
figure file failed (FSERR nnn). 


AGLERR 1515. Figure file is opened 
for both input and output. 


MEANING 


Internal software error; not under 
user control. 


Internal software error; not under 
user control. 


Internal software error; not under 
user control. 


The specified figure does not exist. 
Figure file is being written to at this 
time. 

The specified figure file does not exist. 
Internal software error; not under 

user control. 


Internal software error; not under 
user control. 












Internal software error; not under 
user control. 





Internal software error; not under 
user control. 





internal software error: not under 
user control. 





ACTION 


Contact system manager. 


Contact system manager. 


Contact system manager. 


Check the figure name. 


Try again later. 


Check the figure file name. 


Contact system manager. 


Contact system manager. 


Note file system error number and 


contact system manager. 


Note file system error number and 
contact system manager. 


Contact system manager. 


1132 


1133 


1134 


1735 


1136 


1137 


1138 


1139 


1140 


1141 


ERROR MESSAGE 


AGLERR 1516. System crash flag set 
to true in figure. 


AGLERR 1518. Invalid figure name. 


AGLERR 1800. File system error 
(FSERR nnn) figure not converted. 


AGLERR 1801. !FS/3000 error 
trying to print image (PSPERR nnn). 


AGLERR 1802. OUT2680A error 
(FSERR nnn); figure not converted. 


AGLERR 1803. CREATEPROCESS 
returned error nnn; figure not 
converted. 


AGLERR 1804. SORT/3000 
returned error nnn; figure not 
converted. 


AGLERR 1805. Conversion process 
failed; figure not converted. 


AGLERR 1806. Partitioning process 
failed; figure not converted. 


AGLERR 1807. Figure not converted. 


MEANING 


Error in figure file. 


incorrectly specified figure name. 


Internal software error; not under 
user control. 


Internal software error; not under 
user control. 


PCONVERTFIGURE intrinsic caused 
error in OUT2680A temporary file. 


Figure has not been converted or 


printed. 


Figure has not been converted or 
printed. 


Internal software error; not under 
user control. 


Internal software error; not under 
user control. 


internal software error; not under 
user control. 


ACTION 


Recreate figure file. 


Check the figure name. 


Note file system error number and 
contact system manager. 


Refer to the IFS error number in 
this appendix for more information. 


Refer to the file system error number 
for more information. 


Refer to CREATEPROCESS error 
number in the MPE Intrinsics 
Reference Manual. 

Refer to the error number in the 
SORT/3000 Reference Manual. 
Contact system manager. 


Contact system manager. 


Contact system manager. 


a UO 


Jan 84 
G-41 


1142 


1143 


1144 


1145 


1198 


1199 


410 


411 


412 


413 
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ERROR MESSAGE 


Warning: AGL warning 1851. Figure 
may contain errors. 


Warning: AGL warning 1852. Figure 
may contain errors. 


AGLERR 1808. Image would be 
positioned off page; image not 
printed. 


AGLERR 709. Unable to load 
AGL’2680DDD module; (LOAD ERR 
nnn), 


AGLERR nnn (FS parameter is nnn). 


Warning: AGL warning nnn. (FS 
parameter is n). 


Old IDSCHAR file. Format must be 
converted using IDSCHAR. 


Error encountered while converting 
between devices. 


nn Warning(s) while converting 
between devices. 


Reduction is not available on the 
2688A. 


Internal conversion error; not under 
user control. 








Internal partitioning error; not under 
user control. 











Internal software error; not under 
user control. 








If LOAD ERR number is 65, there 
are not enough system CST entries 
available. 










Internal software error; not under 
user control. 











Internal software error; not under 
user control. 






IFS encountered a font/logo file made 
by an earlier release of IDSCHAR. 


An enviornment file couldn't be 
completely or accurately converted. 


Non-fatal condition(s) while 
converting between devices. 


2:1 and 4:1 environment initialization 
cannot be done for the 2688A. 


ACTION 


Check printed output for errors. 
Check printed output for errors. 


Contact system manager. 


Note LOAD error number and 
contact system manager. 


Contact system manager. 


Contact system manager. 


Bring the font/logo file into the new 
version of IDSCHAR to update the fil 
format. 


Manually inspect the environment an 
correct any incorrectly converted or 
inconverted values. 


None (This is just a warning). 


Select a full size HP-supplied 
environment for you initialization. 





Merging PCELL Files 


The PCELL file merge utility provides the capability to merge two or more separate character fonts into a 
single character font file. This will enable those users who own both the HP 2680A and the HP 2688A Laser 
Printers to store character fonts designed for these devices in the same PCELL file. This makes it much easier 
to recompile the same form for multiple devices since IFS will select the correct font for a device from the 
character font file specified. 


It is suggested that you develop a logical system of merging character fonts within a common file. This will 
be useful when referencing character fonts which normally reside in a file containing different point sizes of 
the same character font. The added distinction using the merge utility is that the character fonts are device 
dependent. In addition, you may not elect to have all point sizes for a character font for both devices. 


The IFS PCELL Merge Utility is an interactive session which runs as a sub-task of the IFS/3000 program. It 
is invoked at the MPE Operating System prompt as follows: 

:RUN IFS.PUB.SYS, IFSUTIL 

The utility will then prompt for the names of the PCELL files you wish to merge and a name for the resulting 


file. If the operation is successful, a message is displayed and you are prompted for another set of files to be 
merged. This process will be repeated until you press without typing a filename; OR, by typing EXIT. 


Example 
:RUN IFS.PUB.SYS, IFSUTIL 
> Cell files to be merged: 


FILE 1: filenamel 
FILE 2: filename2 
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FILE 3: RETURN or EXIT 
> Resulting cell file: newfilenamel 


Cell Files merged successfully. New cell file created. 
END OF PROGRAM 


OR, if you need assistance type ? or HELP at the 
> prompt at any time as follows: 


>? 


OR, 
>HELP 


If any of the input PCELL files specified do not exist, or the file specified is not a PCELL file, or the input 
filenames cannot be opened for any reason, or the newfilename cannot be created, an error message is 
displayed and the > prompt is repeated. If the input filenames are opened successfully and the 
newfilename is created, then the files will be merged as follows: 


e If the two input filenames contain character fonts designed for different devices (i.e. one for the HP 
2680A, and one for the HP 2688A), then the resulting newftlename file will contain all the sizes for all 
the devices contained in the two input filenames, even though the character font may not be identical. 
This enables you to merge character fonts which are not the same font. It is suggested that they be similar 
or a logical substitute in order to maintain an orderly system of font file residence. 


° If the two input filenames contain character fonts for the same device and there are no common point 
sizes, the resulting newfilename file will then contain the combination of all point sizes merged. 


e If the two input filenames contain character fonts designed for the same device and there is a common 
point size, you will then be prompted to make a decision as to which one to put in the resulting 
newfilename file. The two character fonts cannot be combined on a cell by cell basis. The character 
font chosen will be included intact in the resulting file. 
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Updating PCELL Files 


Environment files created and compiled using IFS/3000 versions prior to A.02.01 can be used in their 
compiled form with later software. If these older environment files are recompiled on IFS/3000 A.02.01 or 
later, the environment file will be automatically updated to the new environment file format. 


PCELL files created using IDSCHAR/3000 versions prior to A.01.00 must be converted to the new file 
format before they can be used in the new versions of IDSFORM and IFS. 


The easiest way to convert an old PCELL file is: 
1. Run latest IDSCHAR. 
2. Select the Modify function and enter the name of the PCELL file to be converted. 
3. The file will then be converted, and you will get the following message: 
The file has been updated to the new PCELL format. 
4. Return to the Main Menu or continue working on the file. 


Once an old PCELL file is converted to the new format, that file cannot be used with previous versions of 
IDSCHAR. 


If the PCELL file runs out of space when converting, create a new file and copy the old PCELL file to the 
new file, as shown in the following example: 


: BUILD filename;REC=64,2,F , BINARY ;CODE=PCELL;DISC=40 
:RUN FCOPY.PUB.SYS 

>F rom=oldcellfilename;to=filename 

>Exit 


Now you can go back to step 1 to convert the file. Don’t forget to 
rename the newly converted PCELL file to whatever name was 
originally referenced in any environment files. 
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Graphics can be printed on the HP 2608S, HP 
2563A, HP 2565A and HP 2566A impact printers 
using a subset of the PSP intrinsics. The supported 
intrinsics are: 


e PINITDEVICE 

e PERRMSG 

e PCONVERTFIGURE(A) 

e PFIGUREINFO(A) 

e PFLASHRASTER(A) 

Refer to section 5, Programmatic Interface, for 
more information about these intrinsics. You can 
also plot directly to the HP 2608S, HP 2563A HP 
2565A and HP 2566A printers in the HP Business 
Graphics Products - DSG, HPDRAW, and 
HPEASYCHART. 


The resolution for both printers is 70 dots per inch 
in the horizontal (x) direction and 72 dots per inch 


in the vertical (y) direction. Any units specified 
should be computed using these values. The largest 
image we recommend you specify to be printed on 
these printers is 924 dots (13.5 inches or 342.9 
mm) in the x direction and 720 dots (10 inches or 
254 mm) in the y direction. 


Since environments aren't downloaded to the 
impact printers at print time, the permanent 
downloadable form, downloadable character font, 
logical page and related concepts do not apply. 
Instead, all positioning and rotation is done with 
respect to the physical page. This is why only a 
subset of the graphics intrinsics and none of the 
formatting intrinsics can be used with these 
printers. 


A sample PASCAL program’ using’ the 
PINITDEVICE, PERRMSG, PCONVERTFIGURE and 
PFLASHRASTER intrinsics to print a figure on the 
HP 2563A printer is included on the following 
pages. 
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printer. 


} 


const 
CCE 
cCR 
cStatusOk 


NR DR en phn eatin pan pat 


ype 
Smallinteger 
ComAreaRec 


DevArray 


const 
cDevParm 


type 

agType 
CharArrayType 
LogArrayType 
LogicalRec 


PHPALHAWWWWWWWWWOUNNNNMNDNNNYNDE FF bk be Re RR he : 
RPWNHOWOONAMWPWN HOD DNOUPWNHOODNADURPWONFOOONMDU AONE 
(an) 
(on) 
fon) 


Oo 
oO 
oO 


$PAGES 
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S$USLINIT, STANDARD_LEVEL 
program Quarterly Report 


"HP3000°$ 
(input, output); 


This sample program illustrates the calling sequences for a subset 
of the IFS/3000 graphics intrinsics from Pascal. 
a SpoolFile specifying the logical device name for the 2563A 


The program opens 


2; 
chr(13)-: 
0; 


-32768..32767; 


record 
Status SmalliInteger; 
ErrorNum SmallInteger; 
ErrParml SmallInteger; 
ErrParm2 SmalliInteger; 


MsgFileNum: Smallinteger; 
Reserved : array [1..2995] 
of Smallinteger; 
end; 
= packed array [1..5] of char; 


DevArray [’LP63’ ,cCR]; 


(ByteAddr, WordAddr); 
packed array [1..80] of char; 
array [1..40] of SmallInteger; 
record 
dummybyte : char; {To keep data aligned} 
case AddrTag : TagType of 
ByteAddr (CharArray 
4 WordAddr (LogArray 
end; 


CharArrayType) ; 
LogArrayType}); 


ONODDODDCDDDPDDDVOVDVONO OOOO OOO CO0O9000000 
Oooqc00000CGCOCCOCO0CO0O0OOOQ0qO0qOq0O00 000000090 


SINE EN ODD DHA M HAH DH NNT OTOT ON 
AURWNFHODONDUPOUNE OWOANMDUAWN 
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var 
DeviceClass : DevArray; 
FormalDesignator : packed array [1..9] of char; 
FSErr : Smallinteger; 
ComArea : ComAreaRec ; 
Language : Smallinteger; 
XPosition > real; 
YPosition : real; 
SpoolFileNum : SmalliInteger; 
AreaLlen : Smallinteger; 
OutputDev : packed array [1..6] of char; 
FigureName : packed array [1..16] of char 
FigureFileName : packed array [1..35] of char; 
RasterFileName > packed array {1..35] of char; 
Height : real; 
Rotation : SmalliInteger; 
Units : SmalliInteger; 
RasterNumber : SmalliInteger; 
PositionMode : SmalliInteger; 
function FOPEN : SmallInteger; intrinsic; 
procedure FCLOSE; intrinsic; 
procedure FCHECK; intrinsic; 
procedure FWRITE; intrinsic; 
procedure TERMINATE; intrinsic; 
procedure PINITDEVICE; intrinsic; 
procedure PERRMSG; intrinsic; 
procedure PCONVERTFIGURE ; intrinsic; 
procedure PFLASHRASTER; intrinsic; 
procedure PFIGUREINFO; intrinsic; 
$PAGES 
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procedure CHECK _FOR_ERROR; 


{ 
{ This routine checks the ComArea’s Status to see if an error 
{ occurred. If so, then PERRMSG is called, the error is reported, 
{ and the program terminates. 
{ 
var 
ErrorMsg : packed array [1..80] of char; 
ArrayLen : Smallinteger; 
MsgLen : SmalliInteger; 


begin {CHECK FOR ERROR} 
with ComArea do 


begin {with} 

lf Status <> cStatusOk then 

begin {Get error/warning message} 
writeln (output, ’(IFS Error ’, ErrorNum:1, ’)’)},; 
ArrayLen := 80; 
PERRMSG (ComArea, ErrorMsg, ArrayLen, MsgLen); 
writeln (output, ErrorMsg:MsgLen) ; 
TERMINATE ; 

end; {Get error/warning message} 


end; {with} 
end; {CHECK_FOR_ERROR} 
$PAGES 
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begin {Quarterly Report} 


{ 
virst. Open the Spoolfile. 


FormalDesignator := ’SPOOLOUT ’; 
DeviceClass := cDevParm; 
SpoolFileNum := FOPEN (FormalDesignator 
octal(’604 }, {CCTL, Undef ,Formal ,ASCII , New} 
1, (Write only} 
; {Default RecSize} 
DeviceClass}; 
if ccode <> CCE then 
begin {FOPEN error} 
writeln(output, “Cannot Open Spoolfile’); 
FCHECK (SpoolFileNum, FSErr); 
writeln(output, ‘(FSERR ’, FSErr:1, °)°); 


TERMINATE ; 
end; {FOPEN error} 
{ 
{ Next, Initialize the IFS/3000 intrinsics. 
{ } 
AreaLen := 3000; 
Language := 5; 
OutputDev := -2563A ’; 


PINITDEVICE (ComArea, AreaLen, Language, SpoolFileNum, OutputDev) ; 
CHECK_FOR_ERROR; 


{ 

{ Convert a figure created with DSG/3000 into a raster image. 
{ } 

FigureFileName := ‘'QTRSALES '; 

FigureName := 'SECOND QUARTER '; {Terminated with a blank} 
RasterFileName := ‘R2NDQTR '; {Terminated with a blank} 
Units := 1; {Inches} 

Height := 8.0; (height in incne s} 

Rotation := 0; {Could be CQ, 180, 270} 


PCONVERTF IGURE (ComArea, FigureFileName, Be gureName. RasterFileName, 
OutputDev, Height, Units, Rotation); 
CHECK _FOR_ERROR; 


writeln (’**** Converted figure ‘'}; 


Now print the image positioned relative to the upper left 
corner of the physical page. 


} 


XPosition := 1.5; {Inches to the right} 

YPosition := i. 0; {Inches down the page} 

PositionMode := 0: {Relative} 

PFLASHRASTER (ComArea, RasterFileName, XPosition, YPosition, Units, 
PositionMode}: 


ORO Pn pm 
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167.000 26 1 CHECK _FOR_ ERROR; 

168.000 27 61 

169.000 27 ~#6L writeln (°***** printed 

170.000 28 #1 

171.000 xx  ]j { Finally, close the spoolfile. 

172.000 28 1 { } 

173.000 28 #1 

174.000 28 1 FCLOSE (SpoolFileNum, 

175.000 29 1 

176.000 28 #61 end. {Quarterly Report} 
NUMBER OF ERRORS = 
PROCESSOR TIME O: QO: 
NUMBER OF LINES = 
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raster image 


ELAPSED TIME 0: 
LINES/MINUTE 


NUMBER OF WARNINGS = 


0:13 
1508.6 


0 
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IFS/3000 Reference Guide 
Update for manual part number 36580-90001 


This manual update package corresponds with the software update A.02.03. Changes in the pro- 
gram as well as typographic and informational corrections are included. If your version ID number 
(displayed on your terminal screen when entering and exiting IFS/3000) is lower than A.02.03, and 
you wish to update it, contact your nearest HP Sales and Service Office for assistance. 


Use the pages in this package to update your Interactive Formatting System Reference Guide. Check 
each item off as you complete it. 


Remove These | Insert These 
Old Pages New Pages Changes: (indicated by a vertical bar in page margins) 
i thru xviii i thru xx New title page, printing history,list of effective pages, 
Overview and Contents 
2-3 thru 2-6 2-3 thru 2-6.2 | New topic, Primary and Secondary Character Fonts. 
3-33, 3-34 3-33, 3-34 Additional info on Primary and Secondary Font Fields. 
4-1 thru 4-8 4-1 thru 4-8 |New comareainfo, new paragraph (Carriage Control), 
stack area warning info 


4-19, 4-20 4-19, 4-20 Correction to inrasterfilename description 









Done? 


D-1 thru D-6 New font sizes (11.2 in HELV and ROM families). 
7 
“pew gor 
ok 


| 2b 
SEPTEMBER 1984 i 1A) YS, In U.S.A. 
Dv oo pe ee 






~ 


